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PREFACE 


This manual is directed at programmers using the CONTROL DATA®COMPASS Assembler Version 3. 
This manual describes the principles, features, methods, rules and techniques of producing a 
COMPASS language program. 

The User is assumed to be familiar with the CONTROL DATA®CYBER 70 Series Computer Systems, 
the CONTROL DATA® 6000-Series Computer Systems or the CONTROL DATA® 7600 Computer %stem 
and is assumed to be familiar with assemblers in general. 


Readers with no previous experience with 6000 COMPASS or 7600 COMPASS assemblers are en¬ 
couraged to direct their initial attentions to the following sections of this manual. 


Chapter 1 
Chapter 2 
Chapter 3 
Chapter 4 
Chapter 8 or 9 

Chapter 10 


Introduction 
Language Structure 

Program Structure, sections 3.1 through 3.3 
Pseudo Instructions, sections 4.1 and 4.2 

CPU or PPU Symbolic Machine Instructions, the chapter depending upon the 
machine language the user requires. 

Program Execution 


This publication is not intended as a replacement for the related computer system reference manuals, 
which contain detailed information on machine instructions. Information in the related computer system 
reference manuals takes precedence over information in this publication should discrepencles arise 
between the publications. 


In this manual, numbers occurring in text are decimal unless otherwise noted. Lower case letters in 
formats depict variables. The examples assume that assembler numeric mode is decimal and that 
character mode Is display code unless otherwise noted. In examples, statements generated by the 
assembler as a result of a call or a substitution are shown In shaded print. 


This product is Intended for use only as described in this document. 
Control Data cannot be responsible for the proper functioning of 
undesciibed features or undefined parameters. 
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other documents of interest; 


Model 72, 73, 74, and 6000 Series manuals 

SCOPE 3.4 Reference Manual 
KRONOS 2.1 Reference Manual 
LOADER Reference Manual 
Record Manager Reference Manual 
Record Manager File Organization User’s Guide 
CDC CYBER 70/Model 72 Systems Description and 
Programming Information (vol. 1) (RM) 

CDC CYBER 70/Model 73 Systems Description and 
Programming Information (vol. 1) (RM) 

CDC CYBER 70/Model 74 Systems Description and 
Programming Information (vol. 1) (RM) 

CDC CYBER 70/Models 72, 73, and 74 Instruction 
Descriptions (vol. 2) (RM) 

CDC CYBER 70 Computer Systems-7030 Extended 
Core Storage (RM) 

CDC CYBER 70/Models 72, 73, and 74 and 6000 

Series Computer Systems I/O Specifications (RM) 

Model 76 and 7600 computer manuals 

SCOPE 2 Reference Manual 

CYBER 70/Model 76 Reference Manual 


60307200 

60407000 

60344200 

60307300 

60359600 
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60347200 

60347400 
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60347100 

60352500 


60342600 
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iv 
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INTRODUCTION 


1 


The CONTROL DATA COMPASS Version 3 Assembler provides the user with a versatile, extensive 
language for generation of object code to be loaded and executed on the central processor unit (CPli) or 
a peripheral processor unit (PPU). The assembler executes on the following computer systems and 
operating systems: 

CONTROL DATA® CYBER 70 Series Models 72, 73, and 74 Computer ^sternsunder control of 
SCOPE 3.4 or KRONOS 2.1. 

CONTROL DATA® CYBER 70 Series Model 76 Computer ^stem under control of SCOPE 2 

CONTROL DATA® 6000 Series Computer Systems under control of SCOPE 3.4 or KRONOS 2.1 

CONTROL DATA® 7600 Computer System under control of SCOPE 2. 

From CPU source language subprograms, the COMPASS assembler generates binary point acceptable 
for loading and execution. Subprograms can be compiled independently for subsequent loading and exe¬ 
cution as a single program. 

From PPU source language programs, the COMPASS assembler generates absolute code to be loaded 
and executed on a peripheral processor unit. 

Source statements consist of CPU or PPU symbolic machine instructions and pseudo instructions. The 
symbolic machine instructions (chapters 8 and 9) are counterparts of the binary machine instructions; 
they provide a means of expressing symbolically all functions of the Computer ^stem. 

The pseudo instructions are oriented towards control of the assembler itself; they control the assembler 
much the same as machine language instructions control the computer. The ability to control assembly 
places COMPASS at a level of sophistication much higher than that of the conventional assembler. 

Features inherent to COMPASS include: 

• Free-field source Size of source statement fields is largely controlled by user, 

statement format 


+ References to CYBER 70/Models 72, 73, and 74, with the exception of references to CMU instruc¬ 
tions, apply also to the 6000 Series Computer ^sterns. References to CYBER 70 Model 76 apply 
also to the 7600 Computer System. 
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• Control of local 
and common blocks 


• Preloaded data 


• Data notation 


• Address arithmetic 


• Symbol equation and 
redefinition 

• Symbol qualification 


• Binary control 


• Selective assembly of 
code sequences 

• Mode control 


• Listing control 

• Micro coding 


Programmer and system designate up to 255 areas to facilitate 
interprogram communication. In CPU programs, common areas 
can be defined In small core memory (CM or SCM) or extended or 
large core memory (ECS or LCM). 

Data areas may be specified and loaded in core memory with the 
source program. 

Data can be designated in Integer, floating-point, and character 
string notation. It can be introduced into the program as a data 
item, a constant, or a literal. 

Addresses can be specified making extensive use of constants, 
symbolic addresses, and arithmetic expressions. 

Equation and redefinition of symbols allow extensive parameteriza¬ 
tion of assembly and linkage of subprograms and subroutines. 

Ability to associate a symbol qualifier with a symbol defined within 
a qualified sequence to render the symbol unique to the sequence. 

An unqualified symbol is global and can be referred to from within 
any sequence without qualification. 

The programmer can specify whether binary output is to be absolute 
or relocatable. Absolute code can be generated for any PPU or 
CPU. Relocatable code can be generated for any CPU. Binary can 
be written as overlays or as partial records. 

Assembly-time tests allow the user to select or alter code 
sequences. 

Ability to specify the base to be used for numeric notation not 
explicitly defined as octal or decimal, and to specify the code con¬ 
version to be applied to character data as either display code, 

ASCII, internal BCD, or external BCD. 

Assembly-time control of list content. 

Substitution of sequences of characters defined in the program 
whenever the micro name is referenced. Several micros are 
predefined by the system for user convenience. 
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• Macro coding 


• Operation code table 


• Operation code 
definition 

• Code repetition 

• Remote assembly 

• Library routine calls 

• Diagnostics 


Assembly of sequences of instructions defined in the program or on 
the system library whenever the macro name is referenced. Macro 
definitions can be redefined or purged from the operation code table. 

The programmer can specify or respecify the syntax of a CPU or 
PPU instruction. The assembler generates an entry in the operation 
code table for the instruction. No macro or opdef definition is 
associated with the entry. 

Assembly of sequences of instructions defined in the program or on 
the system library whenever an operation code of the specified 
syntax is referenced. 

Sequences of code can be repeated during assembly or at load time. 

Defers assembly of defined coding sequence until later in the 
assembly. 

Routines can be called from the system library. 

Diagnostics for source program errors are included on output 
listing. 


1.1 OPERATING SYSTEM INTERFACE 

COMPASS executes on a CYBER 70/Model 76 or 7600 CPU under control of the SCOPE 2 Operating 
System or on a CYBER 70/Model 72, 73, 74 or 6000-series computer system CPU under control of 
the SCOPE 3.4 or KRONOS 2.1 Time-Sharing Systems. 


1.2 CONFIGURATION 

The hardware requirements for executing COMPASS on a CPU are the minimum required for the 
operating system. 
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1.3 ASSEMBLER EXECUTION 


COMPASS is called from the system library by a COMPASS control card (chapter 10) or CDC FORTRAN 
compilers upon encountering a COMPASS IDENT statement in the source input file. Parameters 
on the card specify files used during the assembler run such as the file containing source statements 
and the files to receive listable output and load-and-go output. The COMPASS assembler executes as 
a CPU program. 

The operating system allocates the input/output resources as needed and performs all input/output 
required during the assembly. 

COMPASS assembles each subprogram on the source file, in turn, in two passes. During the first 
pass, it reads each source language instruction, expands and edits called sequences as needed, inter¬ 
prets the operation code, and assigns storage. 

The function of the second pass is to assign block origins, locate literals, fill in all valid symbol 
values and produce the assembly listing and binary output. Finally, it prepares the symbolic refer¬ 
ence table and reinitializes itself preparatory to assembling the next subprogram. 

Core requirements for tables used by the assembler are dynamically changed as requirements change 
during assembly. If insufficient core is available for the program, the intermediate file and cross- 
references are transferred to the system mass storage device and assembly continues. If any ECS/ 

LCM space is assigned to the job, COMPASS may use it for table storage. 

All nested processing of macros and similar definitions is handled in a single recursive push-down 
stack. COMPASS has a maximum recursion level of 400; that is, COMPASS allows nesting to a 
depth of 400. 


1.4 RELOCATABLE OBJECT PROGRAM EXECUTION 

I When the assembler has completely processed the source deck, a control card (for example, LGO) 
can be used to call for loading and execution of a CPU object program from the load-and-go file. 
The loader links the newly assembled subprogram to any previously assembled subprograms and sub¬ 
routines referred to by the new program and to programs on any other files specified by the pro¬ 
grammer, After all subprograms are loaded and linked, the operating system begins program exe¬ 
cution at a location specified by one of the subprograms. Data for the object program may be on some 
programmer-specified file. Normally, this loading and execution does not take place if the COMPASS 
assembler detects fatal errors. 
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LANGUAGE STRUCTURE 


2 


2.1 STATEMENT FORMAT 


..e... 

Statements are 80-to-90 column lines, men punched on cards, each card is considered a line. A single 
ftatement may be composed of as many as ten lines. Information beyond column 72 is ^ 

hi rS^PA^S but does appear on the assembly listing. Thus, columns 73-80 can be used for additional 
lomm^nts or ILencii. Column 81-90 are used for sequencing by library maintenance programs, they 
IZZlZ nTuZZ the programmer. A line that contains two or more consecut ve colons may be 
read and printed as two lines because of operating system conventions for delimiting line image. . 


2.1.1 FIRST COLUMN 

The contents of column one designate the type of line, as follows: 

, (comma) Designates the line as a continuation of the previous line, 
♦(asterisk) Designates the line as a comments line, 
other Indicates the beginning of a new statement. 


2.1.2 LOCATION FIELD 

The location field entry begins in column one or ® ^ ^ ent^J^s usually 

plus sign (+) or a minus sign (-) (section 3, 2, 4). 


2.1.3 OPERATION FIELD 

If the location field is blank, the ^Peraimn fieM ,, 

r—dtyre'fr"mJre'bl2^^ ope'r^tion field is blank if there are no nonblank characters 

between the location field and column 30. The following are legal field entries. 

Central processor unit mnemonic operation code and, opUonally, the variable snbfields with each 
variable subfield preceded by a comma. 


Peripheral processor unit mnemonic operation code 
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f'scudo instruction mnemonic operation code 

Macro name 

Blank 


2.1.4 VARIABLE FIELD 

The contents of the operation field determine if any entry is required in the variable field which consists 
of one or more subfields separated by commas. The variable field begins with the first nonblank 
character following the operation field and is terminated by one or more blanks. It is blank if there are 
no nonblank characters between the operation field and column 30. 

A variable subfield contains one of the following; 

Data item 
Hxpression 
Register designator 
Name 

Special element 

Entry uniquely defined for the instruction 


2.1.5 COMMENTS FIELD 

Comments are optional and begin with the first nonblank character following the variable field or, if the 
variable field is missing, begin no earlier than column 30. The beginning comments column can be 
changed through the COL pseudo instruction (Section 4.4.5). 


2.1,6 COMMENTS STATEMENT 

A comments statement is designated either by an asterisk in column 1 or by blanks in columns 1-29. 
Comments statements are listed in assembler output but have no other effect on assembly. A statement 
beginning with * is not counted in line counts for IF-skipping (Section 4. 9) and definition operations 
(chapter 5) and is not included in definitions. A statement having columns 1-29 blank is counted. 


2.1.7 STATEMENT CONTINUATION 

Normally, column 72 terminates a source statement that has not yet terminated. However, a statement 
that cannot be contained in the first 72 characters can be continued on the next line by placing a comma 
in column one and continuing the field in column two. A maximum of nine continuation lines is permitted 
for a statement. The break between lines need not coincide with a field or subfield separator; even a 
•symbol can be split between two lines. Continuation lines beyond the ninth, and continuation lines 
follow'ing a terminated statement are considered comment lines. 
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2.1.8 CODING CONVENTIONS 

Figure 2-1 illustrates a COMPASS coding form that establishes a coding convention as follows: 


Column 

Contents 

1 

Blank, asterisk,or comma 

2-9 

Location field entry or plus, or minus left justified 

10 

Blank 

11-16 

Operation field entry left justified 

17 

Blank 

18-29 

Variable field entry left justified 

30 

Beginning of comments 


All examples in this manual abide by this convention. 


1 CONTROL DATA 

C 

OMPASS CODING FORM 

PROfiMM 

1 NAME 

MUTINC 
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OF 
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Figure 2-1. COMPASS Coding Form 
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2.2 STATEMENT EDITING 


(’OMPASS reads statements in sequence from the .source file. It immediately edits and interprets each 
statement unless (1) it is a comments statement of the type indicated by an asterisk in column one, or 
(2) it i.s part of a definition, that is, it is a statement between a macro or OPDEF header and an ENDM, 
between a DUP or ECHO and an ENDD, or between an RMT pair. Statements within definitions are 
saved for editing and interpretation when the definition is referenced or expanded. Statements within 
the range of a conditional (IF type) pseudo instruction are edited even when they are skipped. COMPASS 
performs two types of editing: concatenation, and micro substitution. 

2.2.1 CONCATENATION 

COMPASS e.xamines the statement for the concatenation character [-► and removes it from any field of 
the .statement so that the two adjoining columns are linked. The most common use of the concatenation 
character is as a delimiter for a substitutable parameter name in a macro definition when there is no 
othci- type of delimiter already there to set off the parameter name. After the substitution takes 
place, the r-is superfluous and is removed by editing before the definition is interpreted. 

Each removal of r* shifts the remaining columns in the statement left one character. This could 
become significant when comments follow a blank variable field because the comments would be 
shifted left and interpreted as a variable field entry rather than comments. 

2.2.2 MICRO SUBSTITUTION 

COMPASS examine.s the statement for pairs of micro marks {^) that delimit references to micro 
definitions (chapter 7 ) and replace.s each reference (including the micro marks) with the micro character 
string referenced. The .string that replaces the reference in the statement can be a different number of 
characters than the reference so that after the substitution, remaining characters in the statement are 
.shifted left or right, accordingly. If, as a result of micro substitution, column 72 of the last card read 
is exceeded, the as.sembler creates up to a maximum of nine continuation cards, beyond which it 
discard.® exce.ss without notification on the listing. No replacement takes place if the micro name is 
unknown or if one of the micro marks has been omitted. The micro marks and name remain in the line. 
In the first case, the a.ssembler flags a non-fatal assembly error. However, a single micro mark is not 
illegal and does not produce an error flag. 

If the iiiicro n.ame is null (i.e. , the two micro marks are adjacent) both micro marks are deleted and no 
error flag i.s set. 

The columnar displacement caused by a micro replacement could also affect the relationship of field.s 
to the beginning comments column. For example, it could shift the operation or variable field right 
l)cyond column .30, or coLdd shift comments left into a blank field. 

yV line that contains two or more consecutive colons after editing may be printed as two lines because 
of operating sy.stem conventions for delimiting print lines. 
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2.3 NAMES 


A name is a sequence of characters that identifies one of the following: 

Subprogram or overlay 
Block 

Macro definition 
Remote definition 

Duplicated sequence (DUP or ECHO) 

IF sequence 
Micro 

A comma or a blank terminates a name. Concatenation marks and pairs of micro marks are removed 
before the name is scanned (see section 2,2 Statement Editing). 

A CPU subprogram name or overlay name is used for linkage with other subprograms. It must begin 
with a letter (A-Z) and is limited to seven characters maximum. Conventions imposed on names by 
the operating system could restrict the use of certain characters in names. There is no restriction on 
the first character for a PPU subprogram or overlay name. For a CYBER 70/Model 76 or 7600 PPU 
assembly, the name can be seven characters but for CYBER 70/Model 72, 73, 74 or a 6000 Series PPU 
assembly it is limited to three characters maximum. In all cases, the last character of a subprogram 
or overlay name cannot be a colon. 

Any other type of name can consist of one to eight characters. A name does not have a value or 
attributes and cannot be used in an expression. 

The different types of names do not conflict with each other. For example, a micro can have the same 
name as a macro, or a subprogram can have the same name as a block, etc. 
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2.4 SYMBOLS 


A symbol is ;i set of charncters that identifies a value and its associated attributes. For an ordinary 
symbol, the first character cannot be a $ or - or a number; a symbol can be a maximum of eight 
characters. A symbol cannot include the following characters, 

+ - * / blank , r* or a 

Other special characters must be used with care, especially in ECHO and macro definitions (chapter 5). 
Conventions imposed on symbols by the operating system could restrict the use of certain characters 
in symbols. 

An external or entry point symbol is used for linkage with other subprograms and has additional 
restrictions (section 2. 4.1 Linkage Symbols). 

Concatenation marks or pairs of micro marks are removed before a symbol is examined (section 2.2 
Statement Editing). In CPU assemblies, to avoid conflict with register designators, a symbol cannot 
normally be An, Bn, Xn, where n is a single digit from zero to seven nor can a symbol be A.x, B.x, 
or X.x, because x is assumed to be a data item by the assembler. However, symbols resembling 
register designators can be used if each use of the symbol is prefixed by =S or =X (section 2. 4. 2). 
Register designators are described further in Section 2.5. 

Fhe process of associating a symbol with a value and attributes is known as symbol definition. This 
can occur in five major ways. 

1. A symbol used in the location field of a symbolic machine instruction or certain pseudo 
instructions is defined as an address having the current value of the location counter (section 
3. 2. 2) and having an attribute defined as follows: 

a. Absolute for the absolute block 

b. Uommon for labeled or blank common blocks (relocatable assemblies only) 

c. Relocatable for local blocks other than absolute during pass one 

d. Absolute for local blocks during pass two of an absolute assembly 

2. A symbol used in the location field of definition pseudo instructions (section 4. 6) is defined as 
hnving the value and attributes derived from an expression in the variable subfield of the 
instiuction. Certain of these pseudo instructions assign an attribute of redefinability to a 
symbol. Unless a symbol is redefinable, a second attempt to define it with a different value 
liroduees a duplicate definition fatal error flag, 

3. An external symbol is defined outside the bounds of the current subprogram and is declared as 
external in the current subprogram or is defined in relation to a symbol declared as external. 

In cither case it has the attribute of external. Unlike a systems symbol, the true value 
definition is not known to the current subprogram. 

4. Definitions of systems symbols that take place outside of the current program can be 
carried over to the current program through the SST pseudo instruction, COMPASS uses 
the true definitions but assigns the additional attribute of systems symbol. 
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COMPASS defines a symbol by default if a reference to a ssrmbol is preceded by =S and the 
symbol is not otherwise defined in the subprogram. This feature is further described 
in section 2.4. 2 Default Symbols. 

There is no restriction on the number of times that the symbol can be referred to in the subprogram. 


Examples: 

Legal Symbols 

P 

R3 

PROGRAM 


Illegal Symbols 


5A 

ABCDEFGHI 

ABE+15 

=.11 


First character numeric 
Exceeds eight characters 
Contains plus sign 
First character equal sign 


2.4.1 LINKAGE SYMBOLS 

A relocatable subprogram can be linked to other subprograms through linkage symbols. The two types 
of linkage symbols are external symbols and entry point symbols. An external or entry point symbol 
can be a maximum of seven characters, the first character must be a letter (A-Z), and the last 
character must not be a colon. 

Any symbol declared as an entry point in a subprogram compiled or assembled independently of the 
current subprogram can be declared as an external symbol in the current subprogram. Any symbol 
declared as an entry point in the current subprogram can be declared as an external symbol in some 
other subprogram. The symbol has a zero value and an attribute of external. An external symbol can 
be declared either through the EXT pseudo instruction or through default (a reference to the symbol is 
preceded by =X, see section 2.4. 2 Default Symbols). 

External symbols can be defined in the subprogram relative to any external symbol declared in an EXT 
pseudo instruction. This is possible through use of symbol definition instructions that assign the value 
and attributes of an expression to a symbol. If the value of the expression reduces to an external 
symbol ± an integer, the location field symbol is defined as having an integer value and external 
attribute. Entry point symbols and external symbols are not qualified (section 2.4.5). 


2.4.2 DEFAULT SYMBOLS 

When a symbol reference is preceded by =S or =X and the symbol is not defined in the subprogram, 
COMPASS defines the symbol or declares it as an external symbol, respectively, at the end of 
assembly. The =X form is defined by default in relocatable assemblies only. 

=Ssymbol If symbol is not defined, COMPASS assigns an address at the end of the zero 

block. All subsequent references to the symbol, whether preceded by =S or not, 
are to the location of the word, A default symbol cannot be used where a 
previously defined symbol is required. 

If the symbol is defined by a conventional method, COMPASS does not define it 
again but uses the programmer definition. 

=Xsymbol This option permits a programmer to define his symbols in a subroutine or link 

to them in another subprogram. If the programmer defines the symbol, the 
assembler uses the programmed definition. If the programmer does not define 
the s 5 rmbol, the assembler assumes that the symbol is external as though declared 
in an EXT pseudo instruction. A symbol prefixed by =X must conform to the 
requirements for external symbols. 


60360900B 


2-7 


The system does not define a default symbol and issues an error flag if a symbol is prefixed by both 
=S and =X, or is prefixed by =X and is not defined conventionally in an absolute assembly. Default 
symbols are qualified by the qualifier in effect at the time of the =S reference. 

2.4.3 PREVIOUSLY DEFINED SYMBOLS 


Certain pseudo instructions require that a symbol in an expression be previously defined. This simply 
means that the symbol, before its use as an expression element, must be defined in a prior instruction. 

2.4.4 UNDEFINED SYMBOLS 

A reference to a symbol that is never defined (not even by default) causes a U error flag to be placed to 
the left of the instruction containing the erroneous reference. 


2.4.5 QUALIFIED SYMBOLS 

A symbol defined when a symbol qualifier is in effect during assembly (section 4.4.3) can be referred 
to outside of the qualifier sequence in which it was defined through: 

/qual ifie r/symbol 

The feature permits the same symbol to be defined in different subroutines without conflict. An 
unqualified symbol is global and does not require a qualifier when it is referenced, unless a qualifier 
is in effect, and a symbol qualified by the same qualifier has been defined. In this case, the unqualified 
symbol can be referenced as // symbol. 

The combination of qualifier and symbol permits a value to be identified by a unique 16-character 
identifier. Linkage symbols are not qualified. 


2.5 CPU REGISTERS 

Register designators symbolically represent the 24 CPU operating registers. These registers are 
described more fully in chapter 8. The designators are inherent to COMPASS and cannot be changed 
during assembly. 

In a CPU assembly, symbols of the same form as register designators may be used if each occurrence 
of such a symbol is prefixed by =S or =X (see section 2.4.2). However, a warning message is issued 
when such symbols are defined. The prefix cannot be used in the location field of machine instructions 
and symbol defining, data generating, BSS pseudo instructions, in the variable field of ENTRY, EXT, 
and SST pseudo instructions. 

Register Type Designator 

Address An or A. n 

Index Bn or B. n 

Operand Xn or X. n 

For the forms An, Bn, or Xn, n is a single digit from 0 to 7. Any other value for n, for example 8, causes 
An, Bn, or Xn to be interpreted as a symbol rather than a register designator. 
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For the forms A. n, B. n, X. n, n can be a symbol or an integer. If the value of n or the value of the 
symbol exceeds 7, the assembler truncates it to the least significant 3 bits and issues a warning flag. 

COMPASS does not recognize registers in PPU assemblies; there, the designators are acceptable as 
ordinary symbols. 


Examples: 

A1 

AlO 

A.l 

A.NUM 
A.10 


Designates address register 1 
Interpreted as a symbol, not a register 
Designates address register 1 

If the value of NUM is 6, it designates address register 6 

Designates address register 2; however, it produces a waiming flag because the 
two was derived from the truncation of 12, the octal value for 10, 


The following produce equivalent results. A SET pseudo instruction (section 4. 6. 2) defines SUM and 
SUB as absolute values 3 and 2, respectively. A reference to a SET-defined symbol produces the same 
result as if the value had been used directly. In this example, the address of ALPHA is 001000. 


Code Generated 

— 

LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


Li 


n 

18 

ho 

6Q32001(<00 

F 


<:83 i 

A2+ALPHA 




LOCATION 

OPERATION 

VAKIAUE COMMENTS 


1 


1) 

18 130 

3 


sun 

SET 

-1- - - 

3 1 

2 


SUP 

SET 

2 i 

6032001000 



S8.SUM 

A.SUB+ALPHA I 


2.6 SPECIAL ELEMENTS 

The following designators are reserved for use as references to special elements and cannot be used as 
symbols. The use of a special element in an expression causes the assembler to replace it with a 
value specified by the element in the expression. The control counters are discussed further in 
section 3. 2. 

Designator Significance 

* or *L The assembler uses the value of the location counter for the block in use. 

The element is relocatable unless the counter in use is for the absolute block. 

♦Q The assembler uses the value of the origin counter for the block in use. The 

element is relocatable unless the counter in use is for the absolute block. 

$ The assembler uses one less than the absolute value of the position counter 

for the block in use. 
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Designator 


Significance 


*p 

The assembler uses the absolute value of the 
position counter for the block in use. 

*F 

The assembler uses an absolute value obtained 
as follows; 


0 COMPASS was called by a COMPASS control 
card 

1 COMPASS was called by the FORTRAN RUN 
compiler (earlier than Version 3.0) 

2 COMPASS was called by the FORTRAN FTN 
compiler or the FORTRAN RUN compiler 
(Version 3.0 and later) 

These designators are inherent to COMPASS and cannot be altered by the programmer during an 
assembly. 


Examples: 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


11 

18 

ho 



JO 

• 

•♦1+B7 

1 

1 



• 

2R 

• 

X3,*L-1 

1 

1 

1 



LOG 

*0-<?ES*PPR 

1 

1 



• 

VFO 

• 

*P/ 

1 



• 

VFO 

• 


1 

1 

1 



TFEQ 


1 

1 


2.7 DATA NOTATION 

Data notation provides a means of entering values for calculation, increment counts, operand values, 
line counts, control counter values, text for printing out messages, characters for forming symbols, 
etc. 

The two types of data notation are character and numeric. The assembler allows the user to introduce 
data in the program in three basic ways. 

As a data item 

As a constant in an expression 
As a literal 
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2.7.1 DATA ITEMS 


Character and nurneric data items can be used In subfields of the DATA (section 4.8.2) and LIT 
(secticMi 4. 8.4) pseudo instructions or as specifications of field lengths on VFD pseudo Instructions. 


2.7.2 CONSTANTS 

A data constant is an expression element consisting of a value represented in octal, decimal, 
hexadecimal, or character notation. It resembles a data item but is restricted by its use as an 
expression element in two ways; 

1, The first character must be numeric, prohibiting (he delimited type of character string 
(section 2.7.4) and the preradix for numeric values. 

2. The field size is determined by the destination field for an expression and can be a maximum 
of 60 bits thus prohibiting double precision floating point numbers. 

2.7.3 LITERALS 

A literal la a read-only constant. It is specified as a data item in a subfleld of a LIT pseudo instruction 
or as an element in an expression. 

The method of specifying a literal in an address ejqiression is nearly identical to that for specifying a 
data item in a DATA (section 4. 8. 2) or a LIT (section 4. 8.4) pseudo instruction. The primary difference 
is that the literal is prefixed with an equal sign, which indicates that a literal follows. 

When a literal is used as an element in an expression, the expression is evaluated using the address of 
the literal in the literals block rather than the value of the data item. Thus, the lit;eral is considered 
relocatable. (For a discussion of the literals block, see section 3.1.3). 
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( onvcntionally, if a literal is used, it is the only element in an expression. 

'I’he first use of a literal causes the assembler to assemble the data specified by the literal, and store 
the data in the literals block using as many words as are required to hold the data. If the binary pattern 
of the prefixed type of literal or of all the literals in a LIT declared sequence matches the binary 
pattern of words previously entered in the literals block, an entry is not generated for the 
data. This process eliminates duplication of read-only data. 

The LIT pseudo instruction permits symbols to be associated with literals block entries. Such entries 
can be referenced symbolically or through use of a prefixed literal. However, to preserve the integrity 
of the literals block, they should be used as read only locations. 

The assembly listing includes a list of the literals block when the D list option is selected (section 4,11.1). 
Example: 


In the following example, using CPU instructions, the first statement creates a word in the literals 
block having the value 00000000000000000001. The address of that entry (for the purpose of the 
example) is 5555 and is used in the address field of the two statements at address 100 and the state¬ 
ment at the lower part of 101. 


The literal in the second statement specifies a right justified character. A, which has a display code 
value of 1. The SB4 creates a one-word literal block entry having the value 00000000000000000002. 
The address of that entry is in the address field of statements at the upper half of addresses 101 
and 102, In this example, the LIT sequence duplicates a sequence of entries in the literals block 
and does not cause new entries to be assembled. 


Location Code Generated 


LOCATION 

OPESATION 

VARIABLE 

COMMENTS 



1 



18 

Iso 

100 

6120005555 



S82 

=1 

1 


6130005555 + 



SB3 

= 1RA 

1 

101 

6140005556 f 



SB4 

= 1RB 

1 


5555 


L 

LIT 

1»? 



6120005555 + 



SB2 

L 

1 

10? 

6130005556 ♦ 



SB3 

Lfl 

1 


COHTEMl OF LITERALS PIOCK. 

005555 oooooooroonooooooooi a 

005555 0000000000000000000? R 
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Continuing the previous example, a LIT sequence as illustrated below, does not duplicate a sequence in 
the literals block and causes entries to be generated in the literals block: 


Location 

Code Generated 


lOCATtON 

OPtRATION 

VARIABLE 

COMMENTS 



} 



)8 

ho 


5557 



LIT 

1,3,1R0.2 1 

1 


( 


00555*5 

005556 

005557 

005560 

005561 

00556? 


CONTENT OF LITEROL? EICCK. 


00000000000000000001 ft 
00000000000000000002 R 
00000000000000000001 A 
00000000000000000003 c 

00000000000000000004 0 
00000000000000000002 B 


However, if the literals sequence in the first part of the example had been followed by a LIT that 
duplicates, in part, the most recent entries in the literals block, only the unduplicated part is added 
to the block. Thus, if the following LIT sequence had been used in place of the LIT 1,3,1RD,2, the 
first two words of the sequence would match the last two words of the literals block so that only two 
additional words would be required to complete the sequence. 


Location Code Generated 


lOCAIION 

OPERATION 

VAIIABU COMMENTS 

5555 

1 


It 

u ho 



LIT 

1»2,3,4 , 


CONTENT OF LITERALS BLOCK. 


005555 onoooooooooooonooool A 
005556 00000000000000000002 B 
005557 00000000000000000003 C 
005560 00000000000000000004 R 
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2.7.4 CHARACTER DATA NOTATION 


(Tiaracter data strings are converted to the code in use at the time the string is evaluated (section 4.4. 2, 
CODE pseudo instruction), and placed in a field indicated by the data type (data item, constant, or 
literal). When no CODE instruction has been issued, conversion is to display code representation. 


Format: 

Data Item 


Constant + 
Liter alt 


sign 

0 

type 

string 

1 



or 



sign 

type 

d 

string 

Zl 



type string 





sign 

n type 

string 

or 


sign 

type d 

string d 


Example 

-3RABC 


-R*ABC* 

3RABC 


=-3RABC 


=-R*ABC* 


Applies to literals used as expression elements only; signifies that a literal follows. 

sign Optional for data item or literal. A sign with a constant is interpreted as an element 
operator. 

+ or omitted The value is positive 

The complemented (negative) value is formed 
n Signifies how the string is determined: 

omitted The string is delimited by d. n cannot be omitted for a constant. 

0 For data item or literal, the string consists of all characters following 

type to: 

blank or , 

For a constant, string consists of all characters following type to: 

+ - * / blank , or A 

n For a data item or literal, n is an integer count of the number of 

characters in the string not counting guaranteed zeros. It is limited 
only by statement size. 

For a constant, n is an integer count of the number of characters in the 
string. It cannot exceed 1/6 of the number of bits in the field that will 
contain the expression, A truncation error is flagged for a right 
justified constant if the most significant bit exceeds the field. Truncated 
zeros do not cause an error in this case, A truncation error is flagged 
for a left justified constant if the least significant bit positions are 
truncated, even if they are zero. 

The string consists of the n characters following type. 


_ Regardless of base, COMPASS assumes that n is decimal, 

f Expression element 
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type 


d 


string 


Character string Justification. The characters formed by the data item 
or constant are right or left Justified into the destination field as follows: 

Type Significance 

C Left Justified with zero fill. For data item or 

literal, 12 zero bits are guaranteed at the end of 
the string even if another word must be allocated. 
For a constant, the zero bits are not guaranteed; 

C is the same as L. 

H Left Justified with blank fill 

A Right Justified with blank fill 

R Right Justified with zero fill 

L Left Justified with zero fill 

Z Left Justified with zero fill. For data item or 

literal, six zero bits are guaranteed at the end of 
the string even if another word must be allocated. 
For a constant, the bits are not guaranteed; Z is 
the same as L. 

A delimiting character used only when n is omitted. The characters 
between the first occurrence of d and the second occurrence of d 
comprise the string, d can be any character other than r-* or 

Characters from one of the COMPASS character sets (appendix D), 
except for those characters that act as delimiters (see n and d), the 
concatenation character (), and pairs of micro marks (?^). 

Concatenation marks and pairs of micro marks are removed by 
editing before a string is examined. A single micro mark can be 
used in a string. 

An empty or omitted character string is defined under one of the 
following conditions. 

1. n is 0 and type is immediately followed by a delimiter, for 
example, OL 

2. n is omitted and the two delimiting characters are adjacent, 

for example, H++ 

Omission of a string in a DATA pseudo instruction is legal and does 
not cause generation of a data word. 

For a constant, an omission of the string is valid and has a zero value. 

An omitted string in a LIT pseudo instruction is legal and does not cause 
generation of a literal for that item; however, the LIT must contain at 
least one non-empty data item. 

An omitted string for a literal in an expression is not legal and produces 
an error. 

It is not possible to generate empty strings using types C, Z, R or A, 
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Examples of character data: 


In these examples, characters are converted to display code representation; all lines of code 
generated by DATA are printed only if the D or G list option is selected. 

Data Items 


Location Code Generated 


144 052222172P5511165520 

145 042i55onooooQoooi]oon 

146 55555555555555555555 


Location Code Generated 


1100 1725 

1101 2420 

1102 2524 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


11 

18 

Uo 



DATA 

L*ERR0R 

IN POQ 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


11 

18 

Iso 



PPU 


—1- 

1 



DATA 

0LOUTPUT 

1 

1 


Constants 


Location Code Generated 


LOCATION 

OPERATION 

VAKIABLE COMMENTS 



I 


n 

18 Iso 

4722 

7130000047 



SX3 

IR* ! 

4723 

7140000060 


TAG 

SX4 

lR«*.fl 1 


5110031117 



SAl 

3RCI0 1 

4724 

6260530000 



S>B6 

X0+1L$ 1 


1117240155 



VFU 

30/4HIOIA,6/1RA,24/0AX+1 

4725 

0155555531 




1 


1725242025 



VFD 

4270LOUTPUT,18/1 

4726 

2400000001 




1 


07000000Q0 



VFO 

15/0LG,1570L| 


Note that the character constant in the expression in the second line consists of a decimal point 
(57 in display code) to which 01 is added before the value is stored. Similarly, in the third field 
of the first VFD, 1 is added to the display code representation of X right justified with blank fill 
(55555530) so that 55555531 is generated. 
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Literals 


Location Code Generated 

— 

tOCATlON 1 

OPERATION 

VARIABLE COMMENTS 

100003765 

100003770 

2652 5110003772 

5120003774 f 

2653 5130003767 + 

1 

_I 

II 

IB |30 

1 

TAGl 

i 

LIT 

LIT 

SAl 

SA2 

SA3 

RA+-*/(A,6L)1= ,.,0Cn,0L 

20HLITERALS 

=0CTENCHARCTS 

=hb-lfft justify with planks* 

= 0L0 


CONTENT CF LITERALS ELOCN, 


003765 00000000004546475051 
003766 52535455565700000000 
003767 33000000000000000000 
003770 14112405220114235555 
00377; 55555555555555555555 
003772 24051603100122032423 
003773 00000000000000000000 
003774 14050624551225232411 
003775 06315527112410550214 
003776 01161323555555555555 


) t • 

0 

LITERALS 

TENCHARCTS 

LEFT JUSTI 
FY WITH PL 
ANKS 


The first LIT pseudo instruction generates three words in the literals block; the OL item is an empty 
string and does not produce an entry. The second LIT pseudo instruction generates one two-word 
entry. The expressions in the variable fields of the SAl, SA2, and SA3 instructions each consist of a 
literal element. The character strings in the SAl and SA2 literals do not duplicate former literals 
block entries so COMPASS generates new entries. However, since SA3 references an existing entry, 
COMPASS places the address of the entry in the address field of the instruction. 
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2.7.5 NUMERIC DATA NOTATION 


Numeric data 
floating point 

Formats : 

Data Item 

Constant 

Literal 

sign 

preradix 


value 


can be specified in octal or decimal notation. The value is converted to an integer or a 
value in single or double precision. 


sign 

pre radix 

value 

[ modifiers 


value 


modifiers 


B 

[sign 

preradix 

value 

modifiers 


Applies to literals only; signifies that a literal follows. 

Optional for data item or literal; a sign with a constant is interpreted as an element 
operator. 


+ or omitted 

The value is positive 

- 

The complemented (negative) value is formed 

Optional for data items and literals; cannot be used for constants. The preradix 
indicates the notation used for the value. 

omitted 

Notation can be specified by a postradix modifier or can be 
assumed from the assembly base. See BASE pseudo instruction. 

B or O 

Octal notation 

D 

Decimal notation 


A series of octal or decimal digits optionally consisting of an integer, a decimal (or 
octal) point, and a fraction. An integer value (fixed point) does not contain a point. 

A floating point value (legal in CPU assemblies only) is noted by the occurrence of 
the point. 

An octal value can be a maximum of 20 significant digits (fixed point) or 32 significant 
digits (floating point). An octal value cannot include 8 or 9. A decimal value cannot 
exceed 1.15 x (fixed point) or 7.9 x lO^S floating point, ignoring the decimal 
point). Extra significant digits cause erroneous results. 

If value is omitted, it is assumed to be zero. 
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modifiers 


Associated with the value are the following optional modifiers specified in any sequence. 
A specific type of modifier can be specified only once. A duplicate produces an error 

flag. 


postradix 


Indicates the notation used for the value. See preradix for legal values. 
An error is flagged if notation contains both a preradix and a postradix. 


decimal exponent 


binary scale 


binary point 
position 


Defines a power of 10 scale factor 


E+n or En or E Single precision 
EE+n or EEn or EE Double precision 

When the sign is plus or is omitted, the exponent (n) is positive. 

When n is omitted, it is assumed to be 0. The value of n cannot exceed 
32767 and is always assumed to be a decimal integer. 

A fixed point value can be single precision (one word) only but a CPU 
floating point value can be generated in double precision (two words). 

If EE is used with a fixed point value, the assembler produces a fixed point 
number in single precision. 

The effect of the exponent is to multiply the value by 10 decimal raised 
to the n power. 

Defines a power of two scale factor and is specified as follows: 


S+n or Sn or b 

When the sign is plus or is omitted, the scale factor (n) is positive. Vi^en 
n is omitted, it is assumed to be 0. The value of n cannot exceed 32767 
and is always assumed to be a decimal integer. 

The effect of the binary scale is to multiply the value by 2 raised to the 
n power. 

Applies to floating point values only and is specified as follows: 


p+n or Pn or P 

When the sign is + or omitted, n indicates the number of bit positions 
the point is to be shifted to the left of bit 0. When the sl^ is -, n 
indicates the number of bits the point is to be shifted to the right. 

The effect of P is to align the value so that the binary point occurs to the 
right of the nth bit. 


The exponent is adjusted to a value of - (j;,n) 

For example, a value with P-6 will have a biased exponent of 2006g; a 
value with PIO will have an exponent of 1765g. 


If P is not specified for a floating point number or if n is omitted, the 
assembler generates a normalized floating point value. The P moditier 
permits generation of an unnormalized value. 

If, as a result of P, the most significant bit of the value is shifted out of 
the coefficient part of the single or double precision number, the assembler 
generates an overflow or underflow error. 


60360900A 


2-19 


Although scale factors can exceed valid ranges, the ranges for numbers are restricted 
by the hardware. 

Example: 

The number 1. 0E4000S-1200 yields a number that is approximately 5. 8 x 10^^ 
and is in range of the floating point representation. 

All calculations are performed in 144-bit precision. The values are rounded to 96 
bits for double precision and to 48 bits for single precision floating point numbers and 
to 60 bits for integers. 

The order in which the assembler acts on the modifiers, regardless of the sequence 
in which they are specified is: 

1. Decimal exponent (single or double) 

2. Binary scaling 

3. Binary point position (CPU assemblies only) 


CPU Numeric Data Items 


Location Code Generated 


LOCATION 

OPERATION 

VARIABLE COMMENTS 



I 


n 

le 130 

1000 

77777777777777777742 


POOL 

DATA 

-29 1 

5001 

17235000000000000000 


NUM 

DATA 

l.OEEl 

5002 

16430000000000000000 




1 

5003 

20000000000000000012 



DATA 

l.OF+lPO 1 

5004 

17760000000000000002 



DATA 

3.2P1S-5E1 ' 

5005 

17154651767635544264 



DATA 

0.0151E+01 1 

5006 

17200314631463146314 



DATA 

0.1P47,-E,DEES 

1 

5007 

77777777777777777777 




5010 

00000000000000000000 

1 1 


1 


CPU Numeric Constants 


Location Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


) 


It 

le 

|30 

5001 ♦ 
555 

5012 

5112 20360 

43760 

7150400000 


ALPHA 

VAL 

FQU 

EQU 

PSSZ 

LX3 

MX7 

5X5 

POOL+l 

555P 

loop 

-14R 

49 

1S17 

-1- 

1 

1 

1 

1 


-20 
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CPU Numeric Literals 


Location Code Generated 


LOCATION 

' - 1 

OPERATION 

VARIABLE COMMENTS 


1 


1) 

ie bo 

5113 5150005151 + 



SA5 

=20046755000234000004B 

5130005152 + 



SA3 

= 1.1 ! 

5153 


ABLE 

LIT 

l.OEEl j 

5155 



LIT 

0.1P47 

5156 



LIT 

-Old 1 

5157 



LIT 

0.0151E+01,-E,DEES 


CONTFNT OF LITERaiS BLOCK. 


005151 200%675500023%00000«i 
005152 17204314631463146315 
005153 17235000000000000000 
005154 16430000000000000000 
005155 17200314631463146314 
005156 77777777777777777754 
005157 17154651767635544264 
005160 77777777777777777777 
005161 00000000000000000000 


PDa B1 d 
OPfLILlLIM 
OS/ 

NO 

OPCLtLtLtL 
»**?»**»♦- 
OH-(--2=7# 


Examples of numeric data (assume default radix is decimal): 
PPU Data Items 


Location Code Generated 


300 

0005 

301 

7766 

302 

0013 

303 

0030 

304 

0002 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

I 


II 

18 

|]0 



PPU 


1 - 

1 



• 

• 

1 



• 

• 

1 



• 

• 

1 



DATA 

5,-90,+813 

,14BS1,24BE-1 

1 
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PPl' Constants 


Location 

Code Generated 


LOCATION 

OPEKATION 

VARIABLE 

COMMENTS 

305 

0000 

I 


II 

18 

|30 



CON 

0,+ll 

- 1 

30 6 

0011 




1 

307 

4443 



CON 

-3334 

1 


31 


ARC 

= 

250 

1 

310 

101 


NWI 

SET 

OlOl 

1 

7777 



CON 

7777 

1 


PPU Literals 


Location Code Generated 


311 ZOOO 1103 
313 2100 1104 
315 2000 1105 



lOCATlON 

OPERATION 

variable comments 

I 

d 


n 

IB |30 



LOC 

= 100 ! 



AOC 

=-i ! 



LOC 

=7777 1 


1103 

1104 

1105 


CCNTFNT OF LITFR«LS PLCCK. 


0012 

2776 

7777 


J 

n 
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2.7.6 HEXADECIMAL DATA NOTATION 


Numeric data can be specified in hexadecimal notation. The value is converted to an int^er in 
single precision. 


Formats; 
Data Item 
Constant 
Literal 


sign 


0 

preradix 


sign 0 preradix 

value modifiers 

B 

preradix 

value 

modifiers 


B 

sign 

0 

preradix 

value 

modifiers 


Applies to literals only; signifies that a literal follows. 

Optional for data item or literal; a sign witii a constant is interpreted as an 
element operator. 

+ or omitted Value is positive. 

Complemented (negative) value is formed. 

The zero is optional for data items and literals but must be present for constants, 
so the preradix will not be taken as the first character of a symbol. 

Must be present to indicate that a hexadecimal value follows. The preradix char¬ 
acter is = or # depending on the printer used. 


value A series of hexadecimal digits. Each hexadecimal digit represents 4 bits and is 

either a decimal digit 0-9 or a letter A-F. The digits 0-9 represent values 0-9 
and the letters A-F represent the decimal values 10-15, 

The value may contain up to 26 significant hexadecimal digits. No radix point is 
permitted. If value is omitted, it is assumed to be zero. 

modifiers The binary scale (S) modifier is optional and has the same form and meaning as 
for octal and decimal data (see section 2.7.5). 


The binary point position (P) modifier is permitted but ignored, since it does not 
apply to Integer values. 
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2.8 EXPRESSIONS 


Entries In subfields of most source statements are interpreted as expressions consisting of a 
combination of one or more terms. Each term consists of one or more elements joined by operators. 

A comma or a blank terminates the expression. 

An expression element can be a: 

Symbol 

Numeric or character constant 
Special element 

Register designator (CPU only) 

Literal 

Examples of elements: 

ALPHA A. 7 3HABC 

$ X3 =10HOUTPUT 

■"P 77BS3 

A term can be a single element or two or more elements joined by the following element operators: 

* Multiplication 

/ Division 

An expression can be a single term or two or more terms joined by the following term operators: 

+ Addition 

Subtraction 

A Logical minus (exclusive or) 

Rules: 

1. If the last element of a term is omitted, COMPASS provides an element of zero. For example, 
if ABLE is a symbol, ABLE*+3 is interpreted as the value of ABLE times 0 plus 3. 

2. Two successive elements are illegal. Note, however, that ** is legal because the first 
asterisk is interpreted as an element, the second asterisk is interpreted as an operator, and 
the blank is interpreted as a null element. 

3. A term can contain one relocatable or external element only. Thus, **ABLE, where ABLE is 
a relocatable address, is illegal because ABLE and * are both relocatable. 

4. The element to the left of a divisor must be absolute. 

5. Division by zero results in zero with no error. 

6. Two or more additive operators (+ or - or A ) in sequence are interpreted as having a term of 
zero value between them, 

7. If an expression begins with an additive ^HJerator (+ or - or a), COMPASS provides a term with 
zero value preceding the operator. 
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The operator that immediately precedes a register designator is the register operator, regardless 
ot the placement of the designator in the expression. The register operator can be: 

+ - * or / 


Examples of expressions: 


«0LF 

$-29 

li- = 3.1‘*t59EE+6 


•4-3 

ABLE*4-72/NUM 

lOB 

34-AB-NUM 
1R=*1R/■ 


Single term 

Two terms; $ and 29 

Two terms; a constant and the address of a literal. COMPASS places the 
literal in the literal block and uses its address in the expression. 

Two terms; value of the location counter and numeric constant 3. 

Two terms, each consisting of two elements; the value of ABLE times 4, 
and 72 divided by the value of NUM. 

Single term consisting of a numeric constant. 

The components of the expression are register A6 and 3-NUM. 

The character constants (= and/) are logically differenced. 


2.8.1 TYPES OF EXPRESSIONS 

Evaluation during assembly reduces an expression to: 

An absolute value (absolute address or an integer value) 
An external symbol + a 21-bit integer 
+ relocatable value + a 21-bit integer 
Register designators and one of the above 
Register designators 


CPU assembly only 


Absolute Expressions 

An expression is absolute if its value is unaffected by progrcim relocation. An expression can be 
absolute, even though it contains relocatable terms, under these two conditions: 

1, The expression contains an even number of relocatable elements 

2. The relocatable elements must cancel each other. That is, each relocatable element (or 
multiple thereof) in a block must be canceled by another element (or multiple thereof) in the 
same block. In other words, pairs of elements in the same block must have signs that oppose 
each other. The elements that form a pair need not be contiguous in the ejq)ression. 

Examples of absolute expressions: 

In the following examples, EASY and FOX are relocatable in the same block. MIKE is absolute. 

The control counters are for the block that contains EASY and FOX. 
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EASY-FOX«-MIKE 

FOX-* 

MIKE+16 

EASY-FOX*2+* 


EASY and FOX cancel each other. 

FOX and the location counter cancel each other. 
The expression contains no relocatable elements. 
EASY and the location ccnmter cancel 2 times FOX. 


Relocatable Expressions 

An expression is relocatable if its value is affected by program relocation. A relocatable expression 
consists of a single relocatable term or, under these two conditions, a combination of relocatable and 
absolute terms: 

1. The expression does not contain an even number of relocatable elements 

2. All the relocatable elements but one must be organized in pairs that cancel each other. That 
is, for all but one block, each relocatable element (or multiple thereof) in a block must be 
canceled by another element (or multiple thereof) in the same block. The elements that form 
a pair need not be contiguous in the expression. 

3. The uncanceled relocatable element can have three kinds of relocation: 

a. Positive program 

b. Negative program 

c. Positive common (Negative common relocation is not permitted by the loader). 

Examples of relocatable expressions: 

In the following examples, EASY and FOX are relocatable in the same block. MIKE is absolute. 
LIMA Is relocatable in a different block. The control counters are for the block that contains 
EASY and FOX. 

LIMa+MIKE-16 

FOX-EBSY+FOX 

3*F0X-2*EASY 

EASY-*<.FOX 

FOX-IOOB/MIKE 

-MIKE*2+LIMA 

=10HMESSAGE 33 


-*0 


The pairing of relocatable terms cancels the effect of relocation because both terms would be relocated 
by the same amount. The comparative value of the two terms remains the same regardless of program 
relocation. 
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External Expressions 


An espression is external if its value depends upon the value of a symbol defined outside of the current 
subprogram. Either an external expression consists of a single positive external term or under the 
following conditions an external expression may consist of an external term, relocatable terms, and 
absolute terms. 

1. The expression contains an even number of relocatable terms. 

2. The relocatable elements must cancel each other. That is, each relocatable element ( or 
multiple thereof) in a block must be canceled by another element (or multiple thereof) in the 
same block. In other words, pairs of elements in the same block must have signs that oppose 
each other. The elements that form a pair need not be contiguous in the expression. 


Examples of external expressions: 


In the following examples, XYZ and ABC are external symbols. EASY and FOX are in the same 
block. The control counters are for the block that contains LIMA. MIKE is absolute. 


XYZ-*+F0X-EASY4-LIMA 

F0X-3*EASY+2»F0X^XYZ 

A8C4-100B 

XYZ^ABC 

-ARC+*-LIMA 

XYZ**0 


The pairs * and LIMA, and FOX and EASY cancel each other. 
The relocatable elements all cancel. 

Illegal; both are external 

Illegal; ABC is negative 

Illegal; *0 is an ui 5 )aired relocatable element 


Register Expressions 

An expressicm is a register expression if, in a CPU assembly. It reduces to one or more register 
designators and an operand. The attributes of the operand can be that of an absolute, external, or 
relocatable expression. Use of register expressions is generally restricted to symbolic CPU machine 
Instructions (Sections 8.4 and 8.5). If the register designator is the first element in the expression, 
the operator can be omitted and is assumed to be +, 

Examples of register expressions: 

In the following examples, XYZ is an external symbol and LIMA is a relocatable symbol. 

X3+LIMA-10B 
LIMA+X3-10B 
-10B+LIHA+X3 
Bli-XYZ 
*+A.NUM 


Produce identical results 
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Evaluatable Expressions 


An evaluatable expression is an expression that does not contain any symbols as yet undefined. Certain 
pseudo instructions require that the expressions be evaluatable. 

2.8.2 EVALUATION OF EXPRESSIONS 

When evaluating an expression, COMPASS replaces each element with a 60-bit value. A character 
constant is first right or left adjusted in a field the size of the destination field and then extended to 
60 bits. Signs are extended for 21-bit quantities, that is, for counters, addresses, and symbols. In 
division, the integral portion of the quotient is retained; any remainder is discarded. Thus, 5/2*2 
results in 4. 

COMPASS forms a term value by interpreting each element and operator from left to right until it 
reaches a » or - or/\ operator. It then notes whether or not the newly formed term contains a 
relocatable or external symbol or register designators. The value of the symbol is added, subtracted, 
or differenced from the cumulative sum of the absolute elements, relocatable elements, or external 
values. The assembler continues evaluating the expression until it is reduced to a symbol and/or a 
value. An error is flagged if the expression cannot be reduced. The expression value is truncated, if 
necessary, and placed in the destination field. If it is too large for the field, the system issues an 
error flag. The maximum field size for an expression is 60 bits. 

The value of an external symbol is zero if the external symbol is defined outside of the subprogram. 

It is the value relative to the external used in defining the symbol if the external symbol was defined 
within the subprogram. 

A zero value is used in place of a register designator. 

For pass one evaluation, the system uses the value of a relocatable symbol relative to the block in 
which the symbol was defined. For pass two evaluation, the system uses a value relative to program 
or common block origin. 

The field size for an expression depends upon the instruction and is determined as follows: 

1. For a symbol definition pseudo instruction, the expression value (including character 
constants) is justified in a 21-bit field. 

2. In a VFD pseudo instruction, the expression is placed in a field of the size specified. 

3. For a CON pseudo instruction, the field size is one word (12 bits for PPU assemblies, 

60 bits for CPU assemblies). 

4. In a symbolic machine instruction, values of e.xpressions are placed in address fields (18 or 
6 bits for CPU assemblies; 18, 12, or 6 bits for PPU assemblies). 

Some relocatable program loaders may give unexpected resrdts if relocatable or external address values 
are assembled into the same field of the same wor ;! niorti Uiaii once, as a result of ORGing backward 
over the word, or by having more than one subprogram pieset a common block. The ORGC pseudo 
instruction (see section 4.5.3) can be used to avoid such problems. 
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PROGRAM STRUCTURE 


3 


This chapter describes the general structure of a program. In some cases, it repeats information 
described elsewhere and correlates it so that the programmer will obtain a better understanding of how 
the program is assembled, loaded, and executed. Some mention is made of the SCOPE loader, but, 
for a complete description of the loader, refer to the reference manual for the operating system in 
use. 

The first topic considered in this chapter is the subprogram block and how the assembler and the 
programmer organize the object code into blocks. Follow'ing this is a brief description of the counters 
that control the blocks. 

Finally, there is a summary of the differences in the structure of absolute and relocatable programs 
and the effect of these differences on block usage. 


3.1 SUBPROGRAM BLOCKS 

A subprogram, whether assembled as absolute or relocatable, can be divided into subprogram areas 
called blocks. As assembly of a subprogram proceeds, the assembler or the user designates that 
object code be generated or that storage be reserved in specific blocks. By properly assigning code 
sequences, data, or reserved storage areas to blocks through use of ORG or ORGC, USE or USELCM, 
a programmer can intersperse instructions for the different blocks. The assembler assigns locations 
in a block consecutively as it encounters instructions destined for the block. A symbol defined within 
a block is not local to the block. That is, it is global and can be referred to from any other block in 
the subprogram. To render a symbol local to a sequence of code requires use of the QUAL pseudo 
instruction (Section 4.4.3). 

Blocks established between two IDENT Instructions, or between an IDENT and END, form a group of 
blocks. COMPASS recognizes a maximum of 255 blocks in a single block group, 252 of which can be 
user-established. When COMPASS interprets an IDENT or END pseudo instruction, it begins pass two 
processing of the completed block group. 


All symbols are assigned absolute values, the table of block names is cleared, the list of USE, 
USELCM, ORG, and ORGC instructions is cleared, and block structuring restarts. For END, the 
symbol table is cleared before the next subprogram is assembled. If the group does not contain a 
USE instruction or if object code is generated (or storage reserved) before the first USE Instruction, 
COMPASS places the code in the nominal block (identified as PROGRAM* on the listing). For an 
absolute program, the nominal block is the absolute block. For a relocatable program, the nominal 
block is the zero block. The user controls use of the nominal block and any user-established blocks 
through USE, USELCM, ORG, and ORGC pseudo instructions (Section 4.5). Each occurrence of a 
non-redundant literal constant causes an entry in the literals block; otherwise, the user has no control 
of this block. 
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3.1.1 ABSOLUTE BLOCK 


The iib.solute block is the nominal block for an absolute assembly. It is identified by the name 
PROGRAM* on the listing. All code generated in the block is absolute. Each address symbol is 
defined during pass one as an absolute value relative to zero which is block origin. The code generated 
must be loaded and executed at the origin specified as the absolute block origin. 

Normally, a relocatable assembly does not contain an absolute block. It may have one established, 
however, if the programmer issues an ORG (or ORGC) request using an absolute value. The assembler 
generates text tables specifying absolute block relocation. The loader loads the absolute text when it 
encounters the text table, without manipulating any addresses. For a relocatable assembly, an ab¬ 
solute block is identified on the assembly listing by the name ABSOLUTE*. There is no ECS/LCM 
absolute block. 

3.1.2 ZERO BLOCK 

The zero block has the block name 0 and is the nominal CM/SCM block for a relocatable assembly. It 
is a local block; that is, it is not accessible to other subprograms. Upon completion of assembly, the 
assembler assigns any undefined default symbols at the end of the zero block. The zero block is 
identified by the name PROGRAM* on the assembler listing. 

An absolute program has a zero block only if the program contains default symbols. In an absolute 
assembly, the zero block immediately follows the absolute PROGRAM* block. 

There is no ECS/LCM zero block. 

3.1.3 LITERALS BLOCK 

COMPASS generates literal data entries in the literals block. It is local to a subprogram. The literals 
block is identified by the name LITERALS* on the assembly listing. COMPASS always assigns storage 
to the literals block immediately following the zero block. There is no ECS/LCM literals block. 

3.1.4 USER-ESTABLISHED LOCAL BLOCKS 

By using USE and USELCM statements, a programmer can establish local blocks in addition to those 
previously described for an absolute or relocatable subprogram. At the end of assembly, COMPASS 
assigns an origin relative to the nominal block to each user-c.stablished local block, in the sequence in 
which they are established. 
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All of the CM/SCM local blocks are concatenated to form a single block, which is treated by the loader 
as a CM/SCM block whose name is unique to the subprogram. Similarly, all of the ECS/LCM'*' local 
blocks are concatenated to fonn a single block which is treated by the loader as an ECS/LCM block 
whose name is unique to the subprogram. 

The length of each ECS/LCM block, including the combined local block, is rounded up, if necessary, 
to an integral multiple of eight 60-bit words. The maximum size of an ECS/LCM block is 
1, 048, 568 words. 

3.1.5 LABELED COMMON BLOCKS 

A labeled common block is a storage area that can be preset with data accessible to one or more 
relocatable subprograms. These blocks are designated during assembly as being in CM/SCM or 
ECS/LCM through the USE and USELCM pseudo instructions respectively, where the name of the block 
is the name enclosed by slant bars; that is, /name/. The tables are designed so that the loader can 
allocate space in memory for the first subprogram that is loaded that declares the block. Thus, the 
first subprogram that names a block sets the maximum size of the block. Each subprogram, as it is 
loaded, can link to allocated blocks or can cause new blocks to be allocated. The contents of a labeled 
common block can be generated by any of the subprograms having access to it. 

If an absolute subprogram attempts to establish a labeled common block by using a USE /name/ or 
USELCM /name/ instructions COMPASS treats the block as a local block having the slant-bar 
enclosed name. 

3.1.6 BLANK COMMON BLOCKS 

A blank common block is a storage area that cannot be preset with data. That is, the loader does not 
load information into the area before the prc^ram is executed. 

For a relocatable program, the CM/SCM and ECS/LCM blank common blocks are allocated space 
by the SCOPE loader after all subprograms are loaded, according to the largest block area declared 
by any of the subprograms. A CM/SCM blank common block is established through use of the USE 
pseudo instruction (section 4.5.1). An ECS/LCM blank common block is established through use of 
the USELCM pseudo instruction (section 4,5.2). A blank common block has no name. A USE // 
indicates blank common in CM/SCM; A USELCM // indicates blank common in ECS/LCM. 


SCOPE 2 does not currently allow LCM local blocks. 
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If no relocatable program declares a blank common block, there is none. If an absolute program 
contains a USE // or USELCM // instruction, COMPASS treats the block as a local block named // 
and data can be stored In this block. 

Only CPU programs can use the USELCM pseudo instruction. 

3.1.7 REDUNDANT BLOCK NAMES 

A CPU subprogram may have two blocks with the same name and the same memory type if they have 
different block types (local or common). Furthermore, a CPU subprogram may have two blocks with 
the same name and the same block type if they have different memory types (CM/SCM or ECS/LCM). 
Thus, altogether, there may be up to four different blocks with the same name. 


3.2 BLOCK CONTROL COUNTERS 

For each block used in a subprogram, COMPASS maintains three counters, an origin counter, a loca¬ 
tion counter, and a position counter. When a block is first established or its use is resumed, 
COMPASS uses the counters for that block. During pass one, the origin and location counters are 
initially zero. During pass two, as the assembler constructs the program, it assigns an initial value 
to each local block origin counter and location counter. Thus, expressions containing relocatable 
symbols are not necessarily evaluated the same in pass one and pass two. 

3.2.1 ORIGIN COUNTER 

The origin counter controls the relative location of the next word to be assembled or reserved in the 
block. It is possible to reserve blank storage areas simply by using either the ORG, ORGC, or 
BSS pseudo instructions to advance the origin counter; ORG and ORGC also permit the programmer 
to reset the counter to some lower location in the block or to change blocks. BSS allows the pro¬ 
grammer to decrement the counter but not to change blocks. The origin counter is incremented by 
one for each word assembled or skipped forward and decremented by one for each word skipped in 
the reverse direction. 

When the special element *0 is used in an expression, the assembler replaces it by the current value 
of the origin counter for the block in use. 
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3.2.2 LOCATION COUNTER 


The location counter is normally the same value as the origin counter and is used by the assembler for 
defining symbolic addresses within the block. The counter is incremented whenever the origin counter 
is incremented. It is possible through the LOG pseudo instruction to adjust the location counter so that 
it differs from the origin counter. This may be desirable when the code being assembled is to be 
loaded at one location and subsequently moved and executed at another location. In this case, the 
programmer resets the location counter to reflect the actual location at which execution is to occur. 

As Lother example of its use, the programmer assembling a large table may reset the 
to zero so that on the listing, the addresses alongside each word of the table reflect the word s Pos^lon 
in the table rather than in the block. Note that use of this technique does not alter the placement of code 
in the block. (For an example of these applications, see the LOG pseudo instruction, section . • •) 
When either of the special elements * or ♦L is used in an expression, the assembler replaces it by 
current value of the location counter for the block in use. 


3.2.3 POSITION COUNTER 


Assume that bits are numbered 59-00, from left to right within a 60-bit GPU word ai^ numbered 
within a 12-bit PPU word. Then, the position counter is initially 60 and 12, respectively, and indicates 
the number of bits remaining in the word. The position counter, which is decremented one for each 
completed bit of an assembled word, becomes 00 when the word is completed, and is reset to 60 or 12 

when a new operation is started. 


For a GPU assembly, the 15-bit and 30-bit GPU instructions cause the position counter to normally 
have values of 60, 45, 30, and 15 reflecting the placement in the word for the next instruction or 
data word to be generated. For a PPU assembly, the normal value is 12. 


The normal pattern of advancement for the position counter can be altered through use of the VFD and 
POS pseudo instructions. 


When the special element *P is used in an eiqiression, the assembler replaces it with the current 
value of the position counter. 


When the special element $ is used in an expression, the assembler replaces it with the curant value 
minus one of the position counter for the block in use; that is, it returns the next available bit position. 


3.2.4 FORCING UPPER 

In a GPU assembly, if any of the following conditions is true, the assembler packs parcels remaining 
in a partially completed word with no-operation instructions (section 8.1), sets the position counter to 
60, and increments the origin and location counters before it assembles code for the next instruction: 

Insufficient room remains in a partially filled word for the next instruction or data to be generated. 

The current statement is a machine Instruction, or a VFD pseudo instruction, with a location symbol 
or + in the location field. 
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ihe current statement is a CYBER 70/Model 72, 73, 74, or 6000 Series RE, WE, PS, XJ, CC, CU, 
DM, or IM instruction. (The programmer can negate this force upper by placing a minus sign in the' 
location field of the instruction.) 

The current statement is an END, BSS,BSSZ, DATA, DIS,'CON, SEGMENT, SEG, IDENT, ORGC, 
LOG, ORG, or MD pseudo instruction. 

The assembler forces upper after it assembles code for one of the follow in g- 

JP 

RJ 

Unconditional EQ 
Unconditional ZR 
ES (CYBER 70/Model 76 or 7600) 

MJ (CYBER 70/Model 76 or 7600) 

PS (CYBER 70/Model 72, 73, 74 or 6000 Series) 

XJ (CYBER 70/Model 72, 73, 74 or 6000 Series) 

IM (CYBER 70/Model 72 and 73) 

This post force upper does not occur immediately, but is deferred until the assembler encounters 
the next machine Instruction or data generating, storage allocating, or binary control pseudo in¬ 
struction in the same USE block. The programmer can negate the force upper following the instruc¬ 
tion by placing a minus sign in the location field of the next instruction. Thus, pseudo Instructions 
following one of the above machine instructions and referencing the origin, location, or position 
counter will use the value before the force upper. 

In a PPU assembly, no forcing upper occurs; the assembler ignores a + in the location field on any 
instruction other than a VFD. A plus or minus in the location field of a VFD in PPU assemblies forces 
the VFD data to begin at the next full word. 

3.3 RELOCATABLE PROGRAM STRUCTURE 

A CPU relocatable program consists of one or more subprograms that can be assembled separately, 
either in the same computer run or in independent runs. The subprogram can all be written in 
COMPASS source language, or can be written in any other source language available in the product set 
of the operating system as long as the compiler or assembler produces relocatable binary output in a 
form acceptable to the loader. A COMPASS language subprogram is composed of instructions 
beginning with an IDENT pseudo instruction and ending with an END pseudo instruction. 

The COMPASS assembler repertoire includes pseudo instructions that facilitate relocatable subprogram 
linkage. Through these linkages, subprograms loaded together can transfer control to each other and 
can access common storage locations. 

Upon completion of assembly of a relocatable subprogram, COMPASS assigns each local block 
an origin relative to the zero block (Figure 3-1). Output is in the form of tables for the Relocatable 
Loader. Each local block thus becomes an extension of the zero block. The length of the 
subprogram given on the assembly listing is the sum of the final values of the origin counters for the 
local blocks, including the zero block and literals block, but not the absolute block. Any absolute text 
is simply inserted at the absolute location relative to RA (S), 

COMPASS binary output for a relocatable subprogram consists of one section for each LCC pseudo 
instruction (if any) in the source program, followed by one section containing the subprogram loader 
tables. 
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High Core 


Blank Common 


Subprogram n 


>Size determined by 
J largest block declared 
by any subprogram 


Low Core 
Address 


Subprogram 3 


Subprogram 2 


Subprogram 1 


Subprogram length 


Sizes and locations 
determined by first 
subprogram declaring 
them 


Blank Common Block 



Core Map of Organization of 

Loaded Program Subprogram 1 


Figure 3-1. Relocatable Program Structure 
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3.4 ABSOLUTE PROGRAM STRUCTURE 


An absolute program consists of code that is not relocatable and must be loaded at specific core 
locations. Because the absolute loader performs no address manipulation, absolute code can be 
loaded more rapidly than relocatable code. 

The programmer has the option of constructing his absolute program as a single unit, or of dividing 
it into overlays. Each overlay consists of data, information, or instructions that are needed at 
different times. EMividing a program into overlays allows several routines to occupy the same core 
storage consecutively so that total storage requirements for a program are reduced. 

During assembly of an absolute program or overlay, COMPASS creates a core image of the absolute 
code. During pass two, it assigns each block an origin relative to the absolute block. Any relocatable 
symbol is reassigned an absolute address; each block effectively becomes an extension of the absolute 
block. Figure 3-2 illustrates the structure of an absolute program that is not divided into overlays. 

The binary output for the program consists of a section for each overlay. Note that the section for an 
absolute program that is not divided into overlays has the same format as the main overlay of a 
program divided into overlays. The user has the option of writing part of a binary section at a time 
by using either a SEG pseudo instruction or an IDENT (other than the first IDENT) with a blank variable 
field. 

An absolute section has three parts: 

1. 77„ prefix table (PRFX) 

O 

2. 50 or 51. overlay table, or a 6000 or 7600 Pf'U header table 

o o 

3. Core image of the program 

The table formats are described more fully in the Loader Reference Manual. 

The amount of binary written as a result of the binary contrcl instruction (IDENT, SEGMENT, SEG, or 
END) is subject to whether or not an entire block group is written. 

If a complete block group is being written icvci ydnng between an IDENT and an END or between 
two IDENT instructions), the core image of the (.rogram or overlay ends with the maximum origin 
counter value for the last block established, that is, with the last word address. 

If only a portion of the binary for the block group is being written, it consists of the core image of 
the program or overlay ending with the value of the current origin counter. 

END, SEGMENT, and a nonblank IDENT complete on overlay and write an end of section. SEGMENT 
and IDENT write header information for the overlay to follow. 
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Figure 3-2. Absolute Program Structure 
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3.4.1 ABSOLUTE OVERLAYS 


When an absolute program contains more than the one IDENT f pseudo instruction or contains SEGMENT 
pseudo instructions, COMPASS does not prepare just one section of a core image of the program as it 
is assembied, but, instead, generates a section for each overlay. 

Dividing the program into overlays permits core to be sequentially overlayed by different subroutines 
and data during program execution, reducing the maximum core requirements for the program. 

For a CPU assembly, the overlay generated is either primary or secondary as determined by the 
IDENT or SEGMENT pseudo instruction. The portion of the program following the first IDENT is 
normally the main overlay and is identified by the level numbers 0,0. Secondary overlays can be 
generated subsequent to the main overlay, A secondary overlay is identified by the level numbers 
x,y, where x is nonzero. 

Conventionally, the main overlay is the first one loaded and contains calls to the operating system 
loader to load one or more overlays as they are required during object time execution. Any overlay 
can call the loader to load another overlay. Control transfers to an entry in the overlay or returns 
to the calling overlay according to the format of the call. (For detailed information concerning CPU 
loader calls, refer to the Loader Reference Manual.) 

Because overlays are not all in core concurrently during program execution and because the sequence 
in which overlays are loaded and executed is beyond the scope of the assembler, it is the user s 
responsibility to assure that an overlay does not refer to symbols, instructions, or data that is not 
concurrently in core. 

Although PPU overlays are not identified by level numbers, they resemble CPU overlays in all other 
respects. 

Overlays generated by using IDENT pseudo instructions differ in certain respects from overlays 
generated by using SEGMENT instructions, as described below. 

Binary formats for overlays are described in the Loader Reference Manual. 


ID ENT-Type Overlays 

The portions of the program from IDENT to IDENT, and IDENT to END comprise the overlays. IDENT 
provides the programmer with the option of specifying the overlay level numbers with each overlay, 
including the overlay generated by the first IDENT. 

If no level number is provided for a CPU assembly, the first overlay is numbered 0,0 and any overlay 
after that is numbered 1,0. IDENT allows each overlay to be assigned unique numbers. Thus, the 
loader has a means of locating a specified overlay when several overlays are written on the same file. 


I IDENT instructions described in this section are assumed to have nonblank parameters. The special 
case of the blank IDENT is described in Section 3.4.3. 
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The first IDENT causes COMPASS to generate the prc^ram or overlay identification information that 
precedes the absolute section. Upon encountering a second IDENT instruction before an END instruc¬ 
tion, COMPASS generates output consisting of a core image of the overlay starting with the overlay- 
origin specified on the previous IDENT and normally ending with the maximum origin counter value of 
the last block declared in the overlay, that is, it normally ends with the last word address. An IDENT 
subsequent to a SEG or SEGMENT, however, generates binary that ends at the location specified by 
the current origin counter. Following the core image, COMPASS writes an end of section and the 
overlay identification information specified by the new IDENT for the overlay to follow. 


For an IDENT-type overlay, COMPASS completes all blocks, including the literals block. Block 
structuring starts fresh with each overlay. This means that each overlay can use the same block names 
used by other overlays, and each overlay can contain a literals block. The USE table and control 
counters are all reinitialized. The origin specified for an IDENT-type of overlay can be any place in a 
previously generated overlay. This is possible beeause IDENT causes the assembler to assign an 
absolute address to each symbol in the symbol table. It can do this because the sizes of all the blocks 
are known. 

Figure 3-3 illustrates a CPU program consisting of a main overlay and a secondary overlay. The main 
overlay uses the absolute block and block A. Default symbols and literals cause the assembler to 
generate a zero block and the literals block. Following the second nonblank IDENT instruction, the 
program overlay origin is set back into the block A. The overlay generates a new literals block 
and new blocks A, C, and D. 
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IDENT, MAIN.X, Y 


BETA 
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END 
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LITERALS' 


A' 


D 


Section Two 



:’50 or 5l Table •:W 


Identification and 
loader control 
word 


MAIN Overlay 
0,0 


End-of- section 


Identification 
and loader 
control information 

Overlay OVl 
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Figure 3-3, IDENT-Type Overlay Structure 
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SEGMENT-Type Overlays 


The portions of the program from the IDENT that identifies the program to SEGMENT, from SEGMENT 
to SEGMENT, and from SEGMENT to END comprise the overlays. SEGMENT provides the programmer 
with the option of specifying the overlay level number with each overlay. 

If no level number is provided for a CPU overlay, the first overlay is numbered 0,0 and any overlay 
after that is numbered 1,0. SEGMENT allows each overlay to be assigned a unique number. Thus, 
the loader has a means of locating a specified overlay when several overlays are written on the same 
file. 

Upon encountering a SEGMENT instruction, COMPASS generates output consisting of a core image of 
the overlay starting with the overlay origin specified on the previous SEGMENT (or IDENT, for the 
first overlay), and ending with the current origin counter value of the block in use at the time the 
SEGMENT was encountered. Following this, COMPASS writes an end-of-section and overlay identi¬ 
fication information for the overlay to follow. 

For SEGMENT, the last block used in the overlay is incomplete. The literals block is in the overlay that 
contains the end of the absolute block. It is the responsibility of the user to assure that all blocks other 
than the one in use are complete. TTie origin of the new overlay can be defined using symbols in the 
block in use only. SEGMENT does not clear the symbol table or reinitialize the USE table. 

Each new SEGMENT-created overlay must use unique block names because blocks established in 
previous overlays cannot be resumed and because the block names remain in the USE table due to the 
incompleteness of the block group. 

Figure 3-4 illustrates a program consisting of a main overlay and a secondary overlay. The main 
overlay uses the absolute block, the literals block, and block A. Default symbols cause the generation 
of a zero block. Following the SEGMENT, an ORG instruction sets the overlay origin back into block A, 
the block in use when the SEGMENT was encountered. The 1,0 overlay establishes new blocks C 
and D. 


60360900 D 


3-13 


IDENT MAIN 



ABSOLUTE 


77 Table 

1 

TAG — 

Block A 


bU or 51 Table 

\ 


MAIN — 
Origin 




ABSOLUTE 

ABSOLUTE 





0 (Default Block) 




TAG-- 

Literals 



Block A 

Block A 

V 


SEGMENT OVl 





ORG TAG 









J 


Block C 


Section One 




\s, 




Block D 


77 Table 

1 


OVl 

::::::50 or 51 I able 

J 

END 


. Origin 





Block A 



Block Structure 


Block C 

- 




Block D 



Section Two 


Identification 
and Loader 
Control 
Information 


MAIN overlay 

0,0 


End-of-section 


Identification 
and Loader 
Control 
Information 

OVl Overlay 

1,0 

End-of-section 


Origin 


Main 

Overlay 




j^INCo^^ 

ABSOLUTE 

0 


Literals 


0 , 0 


Block A 


High Core 
Addresses 


: Lnused 


Origin" 


OVl 

Overlay^ 

1,0 


: MAIN Control Table-: 


ABSOLUTE 


0 


Literals 


Block A 


::::OVl Control Table: 


Block A 


Block C 


Block D 


Overlayed 
Portion of 0, 0 


Core Maps of Loaded Overlays 


Figure 3-4. SEGMENT-Type Overlay Structure 
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3.4.2 MULTIPLE ENTRY POINT OVERLAYS 


When a CPU program or overlay that calls an overlay is assembled independently of the overlay called, 
it may be desirable for the called overlay to identify more than one entry point. Thus, ENTRY pseudo 
instructions are permitted within an absolute assembly and cause the generation of a Slg overlay 
table. This table consists of a control word and a list of overlay entry points. The calling program can 
examine the list and link to any of the entiy points. The 51 g table occupies the area below the overlay 
origin and uses one more word than the number of entries in the table. For the format of the 51g table, 
refer to the Loader Reference Manual. 


3.4.3 PARTIAL BINARY 

When a CPU absolute program or an overlay contains SEG pseudo instructions or IDENT pseudo 
instructions for which the parameters are omitted (blank), COMPASS writes a partial binary section 
consisting of the binary generated since the previous IDENT, SEGMENT, or SEG instruction. How¬ 
ever, it does not write an end of section or a new 77^ table. A SEGMENT, nonblank IDENT, or END 
instruction completes the binary section. 


SEG-Type Partial Binary 

By writing partial binary using SEG, the programmer can reduce the assembler storage requirements. 
A fatal error is issued if the user attempts to store data into a block previously written out or into a 
block that will be written out later. 

When the SEG is encountered, COMPASS writes binary beginning with the first block established in 
that portion of binary and ending with the final count specified by the origin count for the current block. 

SEG does not write a complete block group. The portion of the binary that contains the end of the 
absolute block contains the literals block, if there is one. The symbol table and USE table are not 
reinitialized. 

Figure 3-5 Illustrates how the binary for an absolute program can be written in three separate binary 
writes to reduce the amount of core required to assemble the program. The resulting absolute section 
is loaded and executed as a single program or overlay. 
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Absolute 
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Binary Overlay 


Figure 3-5. SEG-Type Partial Binary 


IDENT-Type Partial Binary 

An IDENT with a blank variable field causes all binary accumulated since the previous IDENT, SEG, 
or SEGMENT to be written out without an end of section or a new 77 prefix table. The USE table 
and the block counters are reinitialized. Each symbol in the symbol®table is assigned an absolute 
address. The blocks in each partial binary section generated in this manner are allocated as if the 
partial binary section were a new subprogram with its own absolute block, literals block, and local 
blocks. This allows portions of a program to be self-contained units even though they are not overlays 
but are loaded as a single unit. The origin of an absolute block for a new portion is the last word 
address plus one of the last block of the previous portion. 

The core image written by a blank IDENT starts with the origin of the absolute block and normally ends 
with the maximum origin counter value of the last block declared in the block group, that is, it normally 
ends with the last word address. If part of the block group has already been written by a SEG or 
SEGMENT, however, the end of the binary is specified by the value of the origin counter for the current 
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COMPASS completes all blocks. The literals block is terminated. Block structuring starts fresh 
with each IDENT. Each new partial binary section created by a blank IDENT can use the same block 
names as are used by the other blank IDENT-created partial binary sections and non-blank IDENT- 
created overlays and each IDENT can contain a literals block but the blocks with the same names are 
independent of each other. 

An attempt to write into or to reset the origin counter to a location in a partial binary section written 
separately causes a range error. 


Figure 3-6 illustrates how the binary for an overlay can be written in three discrete partial binary 
sections to reduce the amount of core required to assemble the program and divide the program into 
self-contained units. The resulting absolute section is loaded and executed as a single overlay. 
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PSEUDO INSTRUCTIONS 


4 


4.1 INTRODUCTION TO PSEUDO INSTRUCTIONS 

This chapter and chapters 5, 6, and 7 describe the pseudo instructions available in the COMPASS 
language. It is impossible to write a program in the COMPASS language without using some of the 
more basic pseudo instructions. The programmer who is new to the language should give special 
attention to these instructions. 


Pseudo Instruction 

Section 

CPU Relocatable 

CPU Absolute 

PPU Absolute 

IDENT 

4.2.1 

X 

X 

X 

ABS 

4. 3.1 

- 

X 

- 

PPU or PERIPH 

4. 3.3 or 

I 

CO 

- 

X 

ORG 

4.5.3 

- 

X 

X 

ENTRY 

4.7.1 

X 

- 

- 

BSS 

4.5.4 

X 

X 

X 

CON 

4.8.6 

X 

X 

X 

END 

4.2.2 

X 

X 

X 


4.1.1 TYPES OF PSEUDO INSTRUCTIONS 

Pseudo instructions discussed in this chapter are classed according to application as follows: 
Subprogram identification (IDENT and END) 

Binary control (ABS, MACHINE, PERIPH, PPU, IDENT, SEGMENT, SEG, LCC, STEXT, 
COMMENT, and NOLABEL) 

Mode control (BASE, CHAR, CODE, COL, Bl= 1, B7= 1, and QUAL) 

Block counter control (USE, USELCM, ORG, ORGC, BSS, LOC, and POS) 

Symbol definition (EQU and=, SET, MAX, MIN, MICCNT, and SST) 

Subprogram linkage (ENTRY, ENTRYC, and EXT) 

Data generaticm (BSSZ and blank operaticm code, DATA, DIS, LIT, VFD, CON, R=, REP, REPC, 
and RE PI) 

Assembly control (ELSE, ENDIF, IFtype, IFop, IF, IFC, IFPL, IFMI, and SKIP) 

Error control (ERR and ERRxx) 

Listing control (LIST, EJECT, SPACE, TITLE, TTL, NOREF, CTEXT, ENDX, and XREF) 

Later chapters describe pseudo instructions that involve definition operations, alterations to the opera- 
ticm code table, and micros. In general, pseudo Instructions can be summarized according to where 
they can be placed in a subprogram. 


60360900C 


4-1 



4.1.2 REQUIRED PSEUDO INSTRUCTIONS 


Two pseudo instructions, IDENT and END, are required for any assembly. IDENT must be the first 
source statement; END signals the termination of source statements for a subprogram. 

4.1.3 FIRST STATEMENT GROUP 

Certain pseudo instructions establish basic characteristics of the assembly and provide the assembler 
with required information. These instructions comprise the first statement group which must precede 
any symbol definition, storage allocation, or object code generation. The following instructions, if used, 
must be in the first statement group. 

ABS 

MACHINE 

PERIPH 

PPU 

STEXT 

4.1.4 PERMISSIBLE ANYWHERE INSTRUCTIONS 

The following pseudo instructions are permissible anywhere, including in the first statement group. 


BASE 

CPSYN 

ENDM 

MICCNT 

OPSYN 

SPACE 

BUI 

DECMIC 

HERE 

MICRO 

PPOP 

SST 

B7=l 

EJECT 

IFC 

NIL 

PURGDEF 

TITLE 

CHAR 

ELSE 

IRP 

NOLABEL 

PURGMAC 

TTL 

CODE 

END 

LIST 

NOREF 

QUAL 

XREF 

COMMENT 

ENDD 

MACRO 

OCTMIC 

RMT 


CPOP 

ENDIF 

MACROE 

OPDEF 

SKIP 



Comments lines and references to macro definitions are also permitted anywhere. 

CPU or PPU symbolic machine instructions and all other pseudo instructions cannot be placed in the 
first statement group. The first use of one of these instructions terminates the first statement group. 


4.2 SUBPROGRAM IDENTIFICATION 


Subprogram identification pseudo instructions designate subprogram begiiming and end. When two or 
more subprograms are assembled in a single COMPASS run called through COMPASS control state¬ 
ment, the end of the source decks is indicated by a 7/8/9 card. 


4.2.1 IDENT - SUBPROGRAM IDENTIFICATION 

An IDENT pseudo instruction of the following form is the first statement of a subprogram recognized 
by the assembler. Usually, any lines preceding the first IDENT or between an END and IDENT are 
assumed to be comments. However, when COMPASS has been called by some other language processor 
such as FORTRAN, the assembler returns control to the processor when the statement following END 
is not IDENT. For a relocatable subprogram, COMPASS flags any subsequent use of IDENT before 
END as an error. For an absolute subprogram, a second form of IDENT described under BINARY 
CONTROL is available for overlay generation. 
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The format of IDENT varies according to the type of assembly. 


CPU Relocatable Format: 



LOCATION 

OPERATION 

VARIABLE SU8EIELDS 



IDENT 

name 

CPU A 

bsolute Formal 

t: 



LOCATION 

OPERATION 

VARIABLE SUBFIEIOS 



IDENT 

name, origin, entry, ij. f 2 

7600 P 

'PU Absolute F< 

srmat: 



LOCATION 

OPERATION 

VARIABLE SUBFIELOS 



IDENT 

name, origin, entry, ppu 


6000 Series PPU Absolute Format; 


LOCATION 

OPERATION 

VARIABLE SUBFIEIDS 


IDENT 

name, origin 


name Name of the subprogram or overlay. The parameter is required. For a CPU 

relocatable or absolute assembly, name can be 1-7 characters, of 
which the first must be alphabetic (A-Z) and the last must not be a colon. 

For a CYBER 70/Model 76 or 7600 PPU assembly, name can be 1-7 characters. 
For a CYBER 70/Model 72, 73, 74 or 6000-Series PPU assembly, name can be 
1-3 characters. In either case, there is no restriction on the first character, 
but the last character must not be a colon. 

origin An expression specifying the first word address of the absolute program or 

overlay. The overlay loader table and all code assembled starting at this 
address and ending with the next SEGMENT, nonblank IDENT, or END instruc¬ 
tion comprises the overlay. For a single entry point CPU program the load 
address for the overlay is origin-1. The word at origin -1 is overlayed by the 
50 loader control table. For a multiple entry point CPU program, the load 
adiress for the absolute overlay is origin-wc-1, where wc Is the number of 
entry points in the 51 loader table. 

O 

For a PPU subprogram, the load address is origin-5. Five 12-bit PPU words 
are overlayed by the 60-bit loader table. 

Data can be generated in locations starting with origin and above, but not below 
origin. The origin subfield does not serve the same function as ORG nor does 
it replace ORG for setting the origin counter. 
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If the origin field is null for an absolute subprogram, the assembler uses 
address 000000 RA(S) as the origin for a CPU program and 0000 as the origin 
for a PPU program. 

For a relocatable subprogram, the subfield is ignored. The loader auto¬ 
matically relocates the first subprogram to be loaded starting at RA(S)+100 , 
the second subprogram starting at the first available location following ® 
the first subprogram, etc. 

®°try For a CYBER 70/Model 76 or 7600 PPU assembly or for an absolute CPU 

assembly, this subfield contains an expression specifying the subprogram 
entry address, which can be symbolic. 

Absolute expressions specifyii^ the level numbers of the overlay, is the 
primary level (0-63) and is the secondary level (0-63). When the first IDENT 
identifies the main overlay, fj and fg can be omitted. If is omitted, it is set 
to 00. If £2 is omitted, it is set to 00. 

Because the first EDENT precedes any use of the BASE pseudo instruction, the 
level numbers on this IDENT are evaluated as decimal unless specifically 
designated as octal by a post radix. 

PPU Absolute expression specifying the number of the PPU on which this program is 

to be loaded. On the first IDENT, this number is evaluated as decimal unless 
specifically designated as octal. 

A location field symbol, if present, is ignored. 

If the COMPASS assembler is called from within a FORTRAN compilation rather than by a COMPASS 
control card, IDENT must be in columns 11-15. 


When the subprogram does not include a TITLE instruction, COMPASS uses the IDENT variable field 
entry as the main subprogram title on the assembly listing. 


Example: 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

I 


11 

18 ho 


CONTROL 

lOFNT 

ARS 

ORG 

BSS 

FNO 

CT .CONTROL,CONTROL 

lARSOLUTE CPU PROGRAM 

HOP 1 

0 OEFINFS SYMBOL CONTROL 


Absolute CPU program CT will be loaded at origin address 00110 


8 * 
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4.2.2 END - END OF SUBPROGRAM 


An END pseudo instruction must be the last instruction of each subprogram. It causes the assembler to 
terminate all counters, conditional assembly, macro generation, or code duplication. Before terminating 
assembly, COMPASS assembles any waiting remote text (see RMT). 

For a relocatable subprogram, the assembler combines all local blocks into a relocatable subprogram 
block, generates the relocatable binary tables and produces the listing. 

For an absolute assembly, the assembler assigns each block an origin relative to absolute zero, 
combines all blocks into an absolute subprogram or overlay, generates the absolute binary section and 
produces the listing. 

END can also be used to signal the end of source statements from an external source (see XTEXT). In 
this case, it does not terminate the subprogram. 

Format: 


lOCATION 

OPeHATION 

VARIABLE SUSFtElOS 

sym 

END 

trasym 


sym 


Optional last word address symbol; if present, COMPASS defines it as the 
total subprogram length, including the literals block and all local blocks. 
The value is the last word address plus one. 


trasym 


A symbol specifying the entry point to which control transfers for a reloca¬ 
table subprogram. This symbol must be declared as an entry point in a 
subprogram — not necessarily the subprogram being assembled. At least 
one subprogram must specify a transfer address or the loader signals an 
error. If more than one subprogram Indicates a transfer address, the loader 
uses the last one encountered. 


For an absolute assembly, trasym is ignored. 


Example: 



LOCATION 

OPERATION 

VAHIAIIE COMMENTS 

1 


11 

16 130 







lOENT 

PROGl j 



ENTRY 

BEGIN , 



• 

. 1 



• 

1 



• 

• 


RFGIN 


1 1 



• 




• 




• 

• 1 



ENfl 

BEGIN 1 
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4.3 BINARY CONTROL 


Pseudo instructions that allow the user extensive control of binary output produced by the assembler 
are summarized below and described fully in this section. 


ABS 

MACHINE 

PPU 

PERIPH 

IDENT 

SEGMENT 

SEG 

STEXT 

COMMENT 

NOLABEL 

LCC 


Specifies CPU absolute binary output 
Specifies processor type 

Specifies CYBER 70/Model 76 or 7600 PPU binary output 

Specifies CYBER 70/Model 72, 73, 74 or 6000 Series PPU binary output 

Begins absolute overlay or writes partial binary section 

Begins absolute overlay 

Writes partial binary section 

Generates system text overlay 

Inserts comments into the 77 prefix table 

O 

Suppresses header information on binary output 

Passes loader control information to the relocatable loader 


4.3.1 ABS-ABSOLUTE CPU PROGRAM 

An ABS instruction declares a CPU program to be absolute. If used, it must be in the first statement 
group. 

The following instructions are illegal in an absolute program: 

EXT 
LCC 
REP 
RE PC 
RE PI 

A symbol can be prefixed by =X if it is also defined conventionally; in this case, the =X has no signifi¬ 
cance because a conventional definition takes precedence (Section 2.4. 2). 

Format: 


LOCATION 

OPERATION : 

variable SU0FIELOS 


ABS 



Symbols in the location and variable fields, if present, are ignored. If a pregram contains both ABS 
and PERIPH (or PPU), the PERIPH (or PPU) instruction takes precedence. 
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Example: 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

I 


11 

16 

Uo 



lOENT 

CT .CONTROL 

.cbNTROL 



flBS 

• 

• 

|AnS0LUT£ CPU PROGRAM 



• 

ORG 

• 

lion 

1 

1 


CONTROL 

RSS 

• 

a 

• 

defines symbol control 

1 



• 

• 

FNO 

• 

• 

1 

1 


4.3.2 MACHINE - DECLARE OBJECT PROCESSOR TYPE 

The MACHINE pseudo instruction specifies the type of computer system on which the object program 
can be executed successfully and optionally specifies hardware features needed by the object program. 
If used, MACHINE must be in the first statement group. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 


MACHINE 

type , hfj, hfg, hfg,..., hf^ 


A location field symbol, if present, is ignored. 

type Character string designating object processor type. The subfield can be any length 

and may contain any characters other than blank or comma. The first character 
identifies processor type, as follows: 

6 The object program is restricted to a CYBER 70/Model 72, 73, or 74 Computer 
System or to 6000 Series Computer System. All machine instructions unique to 
the CYBER 70/Model 76 or 7600 Computer Systems are undefined. 
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7 The object program is restricted to a CYBER 70/*Model 76 Computer System 
or to a 7600 Computer System. With the exception of the PS instruction (which 
is often used for subroutine entry points in CPU assemblies), all instructions 
unique to the CYBER 70/Models 72, 73, and 74 Computer Systems or to the 
6000 Series Computer ^sterns are undefined. 

In a CPU assembly, if the MACHINE pseudo instruction is omitted, or the type 
subfield is blank, or its first character is not 6 or 7, then all CPU instructions 
are defined, and the target and valid fields of the PRFX table in the object pro¬ 
gram are blanks. If the type subfield is present and its first character is 6 or 7, 
the valid field contains 6X or 7X. If the type subfield is at least two characters, 
the first character is 6 or 7, and the second character is a digit (0-9), the target 
field contains those two characters. 

In a PPU assembly, if the MACHINE pseudo instruction is omitted, or the type 
subfield is blank, or its first character is not 6, or 7, then: if the PERIPH 
pseudo instruction is present, MACHINE 6 is assumed; if the PPU pseudo in¬ 
struction is present, MACHINE 7 is assumed. The target field of the PRFX 
table contains blanks, and the valid field contains 6P or 7P. 

Optional subfield, a character string designating an optional hardware feature re¬ 
quired for successful execution of the object program. The subfield may be any 
length and may contain any characters other than blank or comma. It has no effect on 
assembly of the program. The first character of the subfield is placed in the hard- 
ware^instruction-dependencies field in the PRFX table in the object program. 

Recommended mnemonic letters are: 

C Compare/Move Unit 

D Distributive Data Path 

I Integer Multiply Instruction 

L ECS/LCM 

R Interlock Register 

X Central and Monitor Exchange Jumps 

Up to nine hf. subfields are processed; any additional subfields are ignored. If the 
hf. subfields are omitted, the comma following type can also be omitted. 
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Example: 



LOCATION 

OPEIATION 

VARIABLE COMMENTS 

t 


11 

18 ho 



MACHIME 

6*CMU,LCM,xj 


4.3.3 PPU - CYBER 70/MODEL 76 OR 7600 PPU PROGRAM 

A PPU instruction declares a program to be a CYBER 70/Model 76 or 7600 absolute PPU program 
rather than a CPU program. If used, PPU must be in the first statement group. For a description 
of binary format generated as a result of this instruction, refer to the Loader Reference Manual. 

Floating point constants and the following instructions are illegal in a PPU assembly: 


ENTRY 

SEGMENT 

ENTRYC 

USELCM 

EXT 

R= 

LCC 

Bl=l 

REP 

B7=l 

REPC 


RE PI 


SEG 



If the program contains both a PPU and a PERIPH pseudo instruction, the PPU takes precedence. 

PPU programs permit symbols of the form used for CPU register designators; they are normal symbols 
having no special significance. The following instructions are legal but are not applicable in a PPU 
assembly: 

OPDEF 

CPOP 

CPSYN 

PURGDEF 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIDS 


PPU 

J 


J A character string beginning with J supplied in the variable field alters the way 

that COMPASS assembles the variable expression on UJN, ZJN, NJN, MJN, or 
PJN instructions. 
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If J is not specified, COMPASS first tests the range of the ejqjression against 
the short jump limit (+31). If the value is in range, COMPASS assembles the 
jump using the value of the expression. If the value is out of range, COMPASS 
performs a second test, this time using the expression value minus the 
location counter value. If the value is now in range, COMPASS assembles the 
instruction using the expression value minus the location counter value. 
However, if it is out of range, a fatal error is flagged. 

Selection of the J option causes COMPASS to always subtract the value of the 
location counter from the value of the expression. 

As a result, COMPASS is able to differentiate between an expression value 
that is an absolute address in the short jump range from an expression value 
that is a true relative address. 

A symbol in the location field, if present, is ignored. 

Example: 


Location 

Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 



? 


M 

18 

ho 





PPU 


- 1 ■ — 

1 

74 0 



TAC, 

BSS 

POR 

1 

1 

76 0 




UJN 

TAG-» 

1 EXPRESSION < 37B 

1 

Location 

Code Generated 


LOCATION 

OP£»ATrON 

variable 

COMMENTS 



tj 


II 

—- 

16 

|30 



r 


PPU 

• 

JUMP 

-1 

1 

740 




• 


1 

760 

0357 


TAG 

BSS 

20B 

1 





UJN 

TAG 

lEXPRESSION-* < 37R 


4.3.4 PERIPH - CYBER 70/MODELS 72, 73, 74 OR 6000-SERIES PPU PROGRAM 

A PERIPH instruction declares a prc^ram to be a CYBER 70/Model 72, 73, 74 or 6000 Series 
absolute PPU program rather than a CPU program. If used, PERIPH must be in the first statement 
group. For a description of binary output produced as a result of this instruction, refer to the Loader 
Reference Manual. 

Floating point constants and the following instructions are illegal in a PPU assembly: 


ENTRY 

REP 

USELCM 

ENTRYC 

REPC 

R= 

EXT 

RE PI 

Bl=l 

LCC 

SEG 

B7=l 


A symbol can be prefixed by =X if it is also defined conventionally. 


4-10 


60360900A 


PPU programs permit symbols of the form used for CPU register designators; they are normal 
symbols having no special significance. The following instructions are legal but are not applicable 
to PPU assemblies: 

OPDEF 

CPOP 

CPSYN 

PURGDEF 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 


PERIPH 

J 


J A character string beginning with J supplied in the variable field alters the 

way that COMPASS assembles the variable field expression on UJN, ZJN, 

MJN, or PJN instructions. 

If J is not specified, COMPASS first tests the range of the expression value 
against the short jump limit (+31). If the value is in range, COMPASS assembles 
the jump using the value of the expression. If the value is out of range, COMPASS 
performs a second test, this time using the expression value minus the location 
counter value. If the value is now in range, COMPASS assembles the instruction 
using the expression value minus the location counter value. However, if it is out 
of range, a fatal error is flagged. 

Selection of the J option causes COMPASS to always subtract the value of the 
location counter from the value of the expression. 

For an example illustrating how to use J, see the PPU pseudo instruction. 

A symbol in the location field, if present, is ignored. 


4.3.5 IDENT - IDENTIFY AND GENERATE OVERLAY 

Two or more IDENT pseudo instructions are permitted in CPU absolute or PPU assemblies. Second 
and subsequent IDENT instructions having nonblank variable fields cause generation of overlays. IDENT 
differs from SEGMENT in the way it generates overlays. First, it allows the specification of overlay 
numbers. Second, the USE table and all block counters are reinitialized. The symbol table is not 
cleared; all symbols are reassigned absolute addresses relative to absolute zero. Thus, an ORG to a 
previously defined symbol restarts the absolute block at the symbolic address. The third difference is 
that normally the end of the overlay is determined by the last word address, the maximum origin 
counter value of the last block established in the overlay. A preceding SEG or SEGMENT can alter 
this, however (Section 3.4). 


60360900A 


4-11 



I'or a CPU assembly, an IDENT with a blank variable field causes a partial binary write. The 
output is not terminated by an end of section or a new table. However, the USE table and thfe 
block counters are reinitialized and each symbol in the symbol table is assigned an absolute address. 

F'ollowing an IDENT, COMPASS assumes that all blocks, including the literals block are complete. 
Block structuring starts fresh with the new overlay or portion of binary. Thus, each new overlay or 
partial can use the same block names as are used by other overlays or partial and each can have a 
literals block. 

For a blank IDENT, an attempt to write into or reset the origin counter to a location in a partial section 
written separately causes a range error. Following the IDENT, the origin of the new absolute block 
is the next word after the binary written out, that is, it is lwa+1. 

The format of the IDENT varies according to the type of assembly as follows: 

CPU Absolute Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIDS 


IDENT 

name, origin, entry, f ^, f g 


or 


LOCATION 

OPERATION 

VARIABLE SUBFIEIDS 


IDENT 



7600 PPU Absolute Format: 


LOCATION 

OPERATION 

VARIABLE SUBfieiDS 


IDENT 

name, origin, entry, ppu 


6000 Series PPU Absolute Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 


IDENT 

name, origin 


name Name of the overlay. For a CPU program, 1-7 characters, the first of which 

must be alphabetic (A-Z); for a CYBER 70/Model 72, 73, or 74 or a 6000 Series 
PPU program, 1-3 characters; for a CYBER 70/Model 76 or 7600 PPU program, 
1-7 characters. In all cases, the last character must not be a colon. A name 
is a loader linkage symbol required for overlays. 
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origin 


An expression specifying the first word address of the overlay. The overlay 
control word and all code assembled starting with this address and ending with 
the next SEGMENT, nonblank EDENT, or END instruction comprises the overlay. 
For a single entry point CPU program, the load address for the overlay is 
origin-1. The word at origin-1 is overlayed by the 50g loader table. For a 
multiple entry point CPU program, the load address for the overlay is origin- 
wc-1, where wc is the number of entry points listed in the Sis loader table. 

For a PPU subprogram, the load address is origin-5. Five 12-bit PPU words 
are overlayed by the 60-bit loader control table. Data can be generated in 
locations starting with origin and above, but not below origin. The origin 
subfield does not serve the same function as ORG nor does it replace ORG for 
setting the origin counter. The origin of an overlay can be below the origin 
specified on any other IDENT or SEGMENT. 

entry An expression specifying the overlay entry address. When the overlay is 

called, control optionally transfers to this address. 

Absolute expressions specifying the level numbers of the overlay for CPU 
programs only, is the primary level (00-77g), fg is the secondary level 
(00-77g). If base is M, and assumed to be octal. If fj and Ig 

specified, is set to 01 and £2 is set to 00. 

ppu An absolute expression sf>ecifying the number of the PPU in which the overlay 

is to be loaded. If base is M, ppu is assumed to be octal. 

A location field symbol, if present, is ignored. 

The binary is written on the file specified by the B parameter on the COMPASS control card. END 
dumps the last overlay or completes a partially written section. 
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Examples: 


The following program uses IDENT for overlay creation. Symbols T.OVL, O.DMPl, etc. are 
defined on a system text overlay. 


Oi*M 


lOCATION 


DMP 


BH2 


OPEKATION 


lOENT 
ABS 
BASE 
COHMENT] 
LIST 
SST 
ORG 
DUAL 
SXO 


QUAL 

IDENT 

ORG 

SXO 


QUAL 

IDENT 

ORG 

SXO 


OMP.ltT.OVL»O.DHPl 


END 


VARIABLE 


COMMENTS 


I 30 


H 


10/07/70.C 


ONTROL CARO CALL.DMP. 


T.OVL 

DMPl 

61 


0MP2 

0MP2,T.0VL,0 

T.OVL 

B6 + 1 


DMPq 

DMP.9,T.OVL, 
T.OVL 

0.0MP2*F.M0E 


.DMP2 


0.0MP9 


OVERLAY 

DMPl 


OVERLAYS DMP2 
THROUGH 0MP8 




OVERLAY 
0MP9 


kno OVERLAY DMP9 
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The following program uses IDENT instructions having blank variable fields 


1617 




7116 
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4.3.6 SEGMENT - GENERATE BINARY SEGMENT 


The SEGMENT pseudo instruction produces overlays at assembly time. It has many of the features of 
IDENT and is included primarily to provide another way of handling literals. Use of SEGMENT is 
intended for 6000 Series CPU absolute or PPU assemblies. For a relocatable subprogram, a SEG¬ 
MENT pseudo instruction causes BSSZ code and the FILL, REPL, and LINK relocatable tables to be 
written on the binary output file. 

The first SEGMENT causes all binary accumulated since the IDENT to be dumped as the main (0, 0) 
overlay. Each subsequent SEGMENT generates a new overlay with the specified level numbers. END 
dumps the last overlay. When COMPASS encounters a SEGMENT pseudo instruction, it does not clear the 
symbol table or block declarations. All blocks other than the block in use must be complete. For a 
CPU assembly, the literals block must be in one overlay only but that overlay can be any overlay. 


Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 

name 

SEGMENT 

origin, entry, 1^,1^ 


name Name of overlay. For a CPU program, 1-7 characters, first of which must be 

alphabetic (A-Z); for a PPU subprogram, 1-3 characters. In all cases, the last 
character must not be a colon. It is a required loader linkage symbol. 

origin A relocatable expression specifying the first word address of the overlay. 

It can only be an address in the block in use. The overlay loader table and all 
code assembled starting at this address and ending with the next SEGMENT, 
nonblank IDENT, or END Instruction comprises the overlay. 

For a CPU program the load address for the record is origin-1. The word at 
origin-1 is overlayed by the 50g loader table. 

For a PPU subprogram, the load address is origln-5. Five 12-bit PPU words 
are overlayed by the 60-bit loader table. Data can be generated in locations 
starting with origin and above, but not below origin. The origin subfield does 
not serve the same function as ORG nor does it replace ORG for setting the 
origin counter. The origin of an overlay can be below the origin specified on 
any other IDENT or SEGMENT. 

entry An expression specifying the overlay entry address. It is used for CPU 

assemblies only. When the overlay is called, control optionally transfers to 
this address. 

Ij^.lg Absolute expressions specifying the level numbers of the overlay for CPU 

programs only. 1 is the primary level (00-77.), 1„ is the secondary level 

1 O M 

(00-77 ). If base is M, 1 and 1 are assumed to be octal. If 1 and 1 
o X X ^ 

are not specified, 1 is set to 01 and 1 is set to 00. 

X 
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Exampl i: 


— 

location 

OPEtATION 

VARIABLE 

COMMENTS 

1 


)) 

IB 

|30 

— 


lOENT 

SAM,ENTA 

-!.. 



ABS 



■ 


ORG 

HOP 

1 


ENTfl 

PSS 

n 

ENTRT POINT 

1 

i . 


• 

« 




• 

• 

1 

i 


« 

• 


1 

OVLOU 



|OVERLAY LOAD POINT 

1 


• 

• 




• 

e 

1 

( 


• 

« 



SEC.i 

segmen 


R , 



ORG 

ovLor 

1 



PSS 

1 

LOADER TAPLE 


STRT 

OSS 

0 

Ifirst word of overlay 



• 

• 

1 

, 


• 





• 

t 

1 

1 

ENTO 

PSS 

a 

EXECUTION begins HERE 

i 

1 


• 

. 

1 



« 

• 

1 



• 

END 

• 

Ieno of overlay 





i 


SEGl is loaded as an overlay upon a call for the loader from the program. The first word of the overlay 
is loaded at OVLOC +1, following the loader table. Tire entry point to the overlay and the first executable 
instruction is at ENTE. The overlay, when executed occupies the area of the main program be,ginaiGs: 
at OVIjOC. 


4.3.7 SEG - WRITE PARTIAL BINARY 

The SEG pseudo instruction peimlts the generation of c, CPU absolute subprogram or overlaj- inleos c're 
than would otherwise be required for assembly. It is illegal in PPU and relocatable assemblies. 

SEG causes COMPASS to write on the binary output file all binary information accumulated since the 
previous IDENT, SEGMENT, or SEG pseudo instxucbon. It does not write an end of secriou or begin 
a new PRFX table. A SEGMENT, IDENT, or END instruction completes the binam,’ section. 

SEG does not affect the location and origin counters. The user cannot resume use of a block established 
prior to the SEG, except for the block in use when the SEG was encountered. An attempt to reset the 
origin counter so as to resume a block already written out causes an R error. Also, since the block 
group is incomplete and the names of the blocks already written out are still in the USE table, no new 
blocks can be established using the same block names as were used prior to the SEG. 

The literals block is written in the portion that contains the end of the absolute block. 
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4.3.8 STEXT - GENERATE SYSTEM TEXT RECORD 


As a result of an STEXT pseudo instruction, binary output for the subprogram consists of all symbols, 
micros, and opcodes (macros, opdefs, and machine and pseudo instructions), written in overlay 
format at the end of pass one. The STEXT instruction must be in the first statement group. 

The system text overlay becomes available in other assemblies through use of the G or S option on the 
COMPASS control card (chapter 10). Through this feature, information in the system text overlay need 
be processed only once for all COMPASS programs using the same system text. System text overlays 
cannot be generated and used in the same assembly batch; system text overlays generated by one 
COMPASS control card call can be used only by assemblies performed by later COMPASS control card 
calls. 

The symbols included in the system text overlay written are all symbols defined in the assembly 
except those for which at least one of the following is true: 

The symbol value is relocatable or external. 

The symbol is qualified. 

The symbol is redefinable (i. e., defined by SET, MAX, MIN, or MICCNT). 

The symbol Is defined by statements read by XTEXT or occurring behA^een CTEXT and ENDX. 

The symbol is defined by SST (i. e. , is a system symbol input to the present system text assembly). 
The symbol is 8 characters beginning with t t. 

All defined micros are included in the system text overlay. 

All program-defined opcodes are also included. Machine and pseudo instructions automatically 
defined by COMPASS, and opcodes defined by system text input (if any) to the assembly, are not 
Included. 

When a system text overlay is used as input to an assembly through the G or S option on a COMPASS 
control card, all of the micros and <.-)[.)c<xles in the sy.stem text are automatically defined at the start of 
each assembly; however, the symbols in the system text are defined only for those assemblies that 
contain the SST pseudo instruction. 
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A system text overlay on the library is an absolute overlay that has the following control table: 

59_ 48 42 36 _ 00 

I 5000 I 01 I 01 [ 0000000000^ 


Format of Text: 



l^stem Symbol 
Table 

2 words per entry 


Micro Definitions 


Macro/opdef Definitions 


Operation Table 
Entries (2 words per entry) 


Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIDS 

rname 

STEXT 



rname Name assigned to overlay; 1-7 alphanumeric characters, of which the first must be a 

letter (A-Z) and the last must not be a colon. It is placed in the prefix table that 
precedes the overlay. 

If rname is blank, COMPASS uses the name from the IDENT instruction and generate 
the system text only. Otherwise, the system text is generated in addition to the re¬ 
locatable or absolute binary and precedes the binary output on the binary file. 

An entry in the variable field, if present, is ignored. 
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Examp e: 



LOCATION 

OPeRATiON 

VARIABLE 

COMMENTS 

) 


n 

!& 

130 


— 


rOEMT 

OYSTEXT 

-I— 

1 


t 

STEX Y 


1 



BASF 

HIXEO 

1 


JMPRS 

FQU 

100 


1 


• 

« 

« 

1 

1 





'SYSTEM CONSTANTS, SYMBOLS, 





|ano communications areas 



• 


I 



• 

• 

• 

i 



TRTS 

FQU 

7777 

1 - 


' ixr/x 

OPOEF 

X * *i # K 

1 


' ■ . 



1 



« 


■s Y St E ft -L -FINED « AC EOS 

• 

• 

• 

'AND OPDEFS 

1 

ENOM 


1 


SYSCOM 

MACRO 

N 

! 


\ • 

• 

« 




• 

• 

( 


1 • " 


- 

( — 


1 s oft’T 



1 


1! . 

• 

• 

1 


•' . 

• 

« 

jSYSTEM-DEFINEO MICROS 

[ . • 

• 

• 



i 1 

END 


u 



4.3.9 COMMENT—PREFIX TABLE COMMENT 

/he CuTv.itIi;:n pseudo mstn'.iuaon inserts the charaete.r string specified in the variable fiaid irii'.) 

■' ■f'*' T 5 .!v^t, fy.irt'ivai’-tii ''.Y'jV's cf fro ta'r/e In the object program.. The prefix t.s.ble, xad 

uius tiiC cuiiime.ntj is ignoieu ij'y uic loucier but iGent»ii‘^3 the section. If a subpfogrs.m Cv£>,ai5'ss 
than one COMMENT instruction, the new comments are appended to the table for the most recent 
binary control card. If the subprogram contains a NOLABEL instruction, the COMMENT instruction 
is meanin, 3 :less, COMMENT instructions following SEO and blank IDENT pseudo instructions are 
ignored without notification. 


LOCATION 

OPERATION 

VARIABLE SuBFIElOS 

■ 

COMMENT 

String 
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string COMPASS searches the columns following the blank that terminates the operation 

field. If it does not find a nonblank character before the default comments eolumn 
(see COL pseudo instruction), it takes the characters starting with the default 
comments column minus one. Otherwise, the character string begins with the first 
nonblank character following the operation field. In either case, the last character 
of the string is the last nonblank character of the statement. 1 to 10 blanks are 
appended on the right so that the string is followed by at least one blank and the 
length of the string is a multiple of 10 characters. If the variable and comment fields 
are all blanks, the string consists of 10 blanks. If the string length is more than 70 
characters, all characters beyond the 70th are lost. 

A location field symbol, if present, is ignored. Refer to section 4.3. 5 for an example. 


4.3.10 NOLABEL - DELETE HEADER TABLE 

The NOLABEL instruction modifies the format of the binary output produced by COMPASS for an 
absolute assembly by optionally suppressing header information. It is particularly convenient for 
generating deadstart programs which must be loaded at location zero or for writing Chippewa format 
CPU programs. 

Format: 


LOCATION 

OPERATION 

VA8IABIE SUBfIEtDS 


NOLABEL 

I 


I Optional; if the variable field contains a character string beginning with an I, 

COMPASS suppresses all prefix (77g) tables, but retains the other program header 
tables. 

If the I option is omitted, COMPASS suppresses all of the following: 

Prefix tables (77g) 

Overlay control tables (50g) 

Multiple entry point tables (51g) 

PPU header control tables 

A location field symbol, if present, is ignored. NOLABEL is illegal in a relocatable CPU assembly. 
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4.3.11 LCC - LOADER DIRECTIVE 


The LCC pseudo instruction provides a means of including loader directives with the tables for a 
relocatable program. 

Form.st: 


.OCATiON 

1-- 

OPERATION 1 

VARIASLE SUBFIELOS 


LCC 

directive 


directive First nonblank character following LCC to the first blank. For directive 

formats, refer to the Loader Reference Manual. 

’f ia ignored, 

COMPASS writes a directive as a section in packed display code for subsequent interpretation by the 
loader noMPASS does not edit the directive; the loader recognizes illegal foims at load time. 
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Mode contr ol pseudo instructions influence the basic operating characteristics of the assembler. 
Spec.’?!call/, the ’nstraction.! allcv the programmer to alter the way in which the assembler; 


Interprets binary data 
Generates character data 

Interprets the beginning of comments on statements 
Q'.ialifies symbols or does not qualify them 


BASE pseudo instruction 
CODE pseudo instruction 
COL pseudo instruction 
QUAL pseudo instruction 
Bl=l or B7=l pseudo instruction 


iC ctv?e, the ha;" i default rnorie w'hieh it rf.ses if one of these instructions is never used. 


4.4.1 BASE-DECLARE NUMERIC DATA MODE 

The BASE pseudo iDStructio" Hp^Jares the mode of interpretation for numeric data for which a base 
”adix is not explicitly defined. Use of the BASE pseudo is optional; if BASE is not used in a subpro¬ 
gram, COMPASS evaluates unspecified numeric data as decimal. 

An alternate application of BASE is to define the previous base as a micro. 

i orraatr 


LCCAfiON 

OPERATION 

VARiASlE SUSFIElDS 

mname 

BASE 

mode 


mname Optional 1-8 character micro name by which the previous BASE mode can be referenced 
in subsequent BASE instructions. If mname is present, the value of the micro named 
mname is (re)defined to be a single letter D, M, or O, corresponding to the BASE mode 
in effect prior to this BASE instruction. 


/ 
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mode 


Blank, in which case the base remains unchanged, or 1-8 characters, the 

first of which designates the new base as follows: 

O Octal assembly base; any subsequent use of a data item not 

specifically identified by an O, D, or B prefix or suffix is 
evaluated as octal. For example, the constants 15 and 15B 
are evaluated as 15g; constant 15D is evaluated as 17g. Any 
item containing an 8 or 9 without a D radix is flagged as 
erroneous. Exceptions are scale factors, character counts, 
shift counts (S modifier), and binary point positions, which 
are always considered decimal. 

D Decimal assembly base; any subsequent use of a data item 

not specifically identified by an O, D, or B prefix or suffix 
is evaluated as decimal. 

M Mixed assembly base; any subsequent use of a data item not 

specifically identified by an O, D, or B is evaluated as decimal 
if it is one of the following. Otherwise, it is evaluated as 
octal. 

VFD bit count 

IF, ELSE, or SKIP line count 

MICRO, OCTMIC, or DECMIC character count 

B, C, or I subfield in REP or RE PI 

DUP or ECHO line count 

Character count 

Shift counts (S modifier) 

Scale factors 
Binary point position 
COL column number 
DIS word count 
SPACE line count 

+ Use base in effect prior to current base. The assembler records 

occurrences of BASE pseudo instructions and maintains a table 
of the most recent 50 occurrences. Each BASE * resumes use 
of the most recent entry and removes it from the list. When the 
subprogram contains more BASE * instructions than there are 
entries in the stack, COMPASS uses a decimal base. 

other If the variable field is not blank and does not contain one of the 

above, COMPASS sets an error flag. 
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Exampl 3s: 


This example illustrate j the affect of BASE on a VFD instruction that defines a 48-bit field 

containing 10 . 

8 


Code Generated H 

LOCATION 

OMtATION j 

VA«IABIE COMMENTS 




II 

18 iiC 

Di*0 



BASE 

0 ! 

ooot oocnooBOOOlO 



VFO 

60/10 * 




• 

. 1 




• 

• i 

0,»0 



BASE 

0 1 

aooo 



VFO 


a 0 0 i; 0 a 0 0 0 010 




1 




• 

• 1 




• 

• 1 



i 

S&SE 

M j 


vr0 


ooonooio I 1 


1 ' 


The following example illustrates the micro capability of BASE: 


j 

,OCATiON 

— 

OPetATION 

VABIAILE 

COMMENTS 

w 


1) 

16 

Iso 

r 


BASE 

K 

iS^VE BASE USE 


• 

• 

• 

1 


• 

• 

• 

.CODE USING BASE M 


« 

• 

BASE 

4SAVEB« 

Irestore saved base 



•ASE 




• 

♦ 

• 



• 

• 

• 

1 




• 



4.4.2 CHAH-DtERNE OTHER CHARACTER DATA CODE 

The CHAR pseudo instruction defines character data codes to be used when the CODE O (for Othe’*) 

inlOU'U iii 


Format; 





char 


■1 --- 


expl,exp2 


no;- 


ex-. l Evaluatable absolute expression whose value is 00 to 778. The value of expl 

is the display code value of the character to be redefined. 

exp2 Evaluatable absolute expression whose value is 00 to 778- The value of exp2 

is the new code other value of the character designated by expl. 
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A location field symbol, if present, is Ignored. 

Initially, all code other values are the same as display code, CHAR need be used only for those 
characters whose code other values are different from display code. Characters may be redefined 
as many times as desired by subsequent CHAR pseudo Instructions. 

Example; 



lOCATION 

OPERATION 

VAIIAIIE SUBFIEIDS 

00r*6.1 


CHAR 

CHAR 

0«63B 

6i0»O 

INTtKCHANOE 

percent for 

COLON AND 
CODE OTHER 


4.4.3 CODE - DECLARE CHARACTER DATA CODE 

The CODE pseudo instruction declares that until the next CODE pseudo instruction is encountered all 
constants, character strings, and character data items are to be generated in the specified code. 
Character data can be generated in ASCII t, display, external BCD, or internal BCD, codes. If no 
CODE instruction is used, COMPASS generates display code. Codes are given in appendix D, 

An alternative application of CODE is to define the previous code as a micro. 


Format: 


LOCATION 

OPERATION 

VARIABLE SUBEIELOS 

mnEime 

CODE 

char 


mname Optional 1-8 character micro name by which the previous CODE mode can be referenced 
in subsequent CODE Instructions. If mname is present, the value of the micro named 
mname is (re)deflned to be a single letter A, D, E, or I, corresponding to the CODE 
mode in effect prior to this CODE instruction. 

char The first character of a string Indicates the code conversion: 

A ASCII six-bit subset 
D Display 
E External BCD 

I Internal BCD 

O Other code, defined by CHAR pseudo Instructions. 

* Use code in effect prior to current code. The assembler records occurrences of 

CODE pseudo instructions and maintains a table of the most recent 50 occurrences. 
Each CODE * resumes use of the most recent entry and removes it from the list. 
When the subprogram contains more CODE * instructions than there are entries in 
the stack, COMPASS generates display code. 

tAmerican Standard Code for Information Interchange. 
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ExampL : 


Code Generated 


LOCATION 

OPERATION 

VAIIAtlE COMMENTS 


1 


11 

18 |30 

17? 2 y 25^:40 00(5 000 0 



DATA 

OLOUTPUT 1 

Dr A 



COUE 

ASCII 

6765646i]65640i)QuJOaL 



DATA 

OLOUTPUT 1 

A,»E 



CODE 

EXTERNAL BCD 

462423472423000U0000 



DATA 

OLOUTPUT 1 

Erl 



CODE 

INTERNAL BCD 

466463476463QOu GjOOU 



DATA 

OLOUTPUT 1 

TrD 



CODE 

DISPLAY , 

17252420252400000000 



DATA 

OLOUTPUT I 

nrl 



CODE 

• 1 

466463476463000UOQuG 



DATA 

OLOUTPUT ^ 


4.4.4 QUAL - QUALIFY SYMBOLS 

The Ql AL pseudo instruction signals the beginning of a sequence of code in which all symbols defined 
in it are either qualified or are unqualified (global). If no QUAL is in a subprogram, all symbols are 

dstiaeii as glODai. 

An alternative application of QUAL is to define the previous qualifier as a micro. 

Within a QUAL sequence in which a symbol is defined, a symbol reference need not be qualified. 

Used outside the sequence, the symbol must be referenced as/qualifler/symbol. Thus, a symbol and 
a qualifier become a unique identifier local to the sequence in which the symbol was defined. The 
same symbol used with a different qualifier is local to a different QUAL sequence. If a symbol is 
defined with no qualifier as well as being defined as qualified, a reference to the symbol within the 
QUAL seouence is assumed to be a reference to the qualified symbol ralher than to the global sytobol 
Ir this eaf ?, ■ rsfereace to the global symbol must be preceded by a blank QUAL and followed by a 
QUAL 


Lefauk symbols and linkage symbols are not qualified. 


lOCA-yoN 

1 

OPERATION 

VAi<lA8LE SU6FIEIPS 

1 

iBtuaaiiie 

! 

1 

QUAL 

qualifier 


Optional 1-8 character micro aaire by which the prevlou.s quauifler can be 
referenced in subsequent QUAL Instructions or symbol references. If mname 
is present, the value of the micro named mname Is (re)deflned to be the 0-8 
characters comprising the qualifier in effect prior to this QUAL instruction. 
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qualifier 


A symbol qualifier or * or blank, as follows: 


qualifier 1-8 character name, the first character of which cannot be $ or = 
or numeric. The qualifier cannot contain the characters 

+ - * / , or A 
A blank terminates the qualifier. 

Any symbol defined subsequent to this QUAL up to the next 
QUAL must be referenced from outside the QUAL sequence as 

/ qualifier/symbol 

The Current qualifier appears as the third sub-subtitle on the 
assembly listing (section 11.1). 

* The assembler resumes using the qualifier in use prior to the 

current qualifier. The assembler records occurrences of QUAL 
pseudo instructions and maintains a table of the most recent 50 
occurrences. Each QUAL * resumes use of the most recent entry 
and removes if from the list. When the subprogram contains more 
QUAL * instructions than there are entries in the stack, 

COMPASS uses the null (global) qualifier. 

blank A blank variable field causes any symbols defined up to the next 

QUAL to be global. A global symbol does not require a qualifier. 

NOTE 

The first attempt to redefine a global symbol from 
within a QUAL sequence results in A and U errors. 

The symbol is defined local to the QUAL sequence 
with a zero value. To avoid fatal errors, precede 
any redefinition instruction (SET, MAX, MIN, or 
MICCNT) within a QUAL sequence with a blank QUAL 
and follow it with a QUAL *. 
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Examples: 



lOCATION 

OPEHATION 

VARIABLE 

COMMENTS 


1 


n 

18 

Uo 





QUAL 


1 





'jxe 

• 

F 

• 

lacoE 

1 

QUALIFIED 8V PASSl 



• 

FO 

« 

LOCI 

1 





DUAL 

PA3F? 

1 




^rot 

FOU 

LOC? 

Ircoe 

QUALIFIED BY PASS2 



QUAL 

• 

• 

ISYMBOLS 

1 

CIOBAL FROM NOW ON 



• 

« 

B3^ 

« 

* 

1 

■GLOB 

IS 

^■tOSAL 



• 

RJ 

/PflSSl/BCOF 

• 

1 

1 JUHP 

1 

TO 

PASSl ROUTINE 



• 

RJ 

• 

/PASSP/RCDF 

! JUMP 

TO 

PASS? ROUTINE 


Location Code Generated 


LOCATION 

OPERATION 

VAHAIIE COMMENTS 


1 



!3 |30 



TAP 

MACRO 

BLOCK,EMAL . 




USE 

BLOCK 1 




DUAL 

KWAL 



TARl 

PSS 

IffB 



TAG? 

VEO 





USE 

* 1 




dual 

♦ 1 



■ 

FNDM 

i 




• 

• 

TAB 

I 

OMF,ONF 1 




USE 

owe , 





OMF ' 



TiCI 

•SS 

tSB 1 

tWfA 77rffrrfTmr77rTr7% 


TA67 

vm • 

EtF-l 1 




USE 

• ' 




m&L 

• 1 




TAB 

! 

TWO, TWO . 

. .. ' 



use 

TMO , 




WJAt 

sue 1 

mm3 


mi 

css 

Its 1 

tmss TftfTfTrrrrrfTTWTfTB 


tm 

VPO 

’ 1 




use 

• 1 




OUAt 

♦ ■ 1 




EMOM ’ 

1 
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1 

LOCATION 

QQIQI 

VARIABLE 

COMMENTS 


I 


DHHI 

18 

Uo 








QUAL 

z 

1 



71 

8SS 

0 

Izi QUALIFIED BY 

7 



• 

• 

1 • 




• 


' • 




• 

• 

1 • 




OUAL 

B 

.EQUATE SYMBOLS 

SO THAT 


Z1 

s 

/Z/Zl 

|Z1 IN Z CAN BE 

REFERRED 


|T0 AS Z1 IN B 


4.4.5 B1 = 1 AND B7 = 1 - DECLARE THAT B REGISTER CONTAINS ONE 

The Bl=l and B7=l pseudo instructions declare that in this CPU subprogram, the contents of the B1 
register or the B7 register, respectively, are one. These instructions do not produce code; they alter 
the way in which code is generated by the R= instruction (Section 4. 8.7) and define the symbol Bl=l 
or B7=l. If more than one instruction is used, the assembler uses the last one encountered. 

Formats: 


LOCATION 

OPERATION 

VARIABLE SUBFIELOS 


Bl=l 

B7=l 



A symbol in the location or variable field is ignored. 

Note that loading the respective B register with one is the user's responsibility. 
For an example of use, refer to R= (Section 4.8.7). 
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I 4.4.6 CDL-SET COMMENTS COLUMN 

The COL pseudo instruction sets the column number at which the comments field can begin when the 
'ariable field is blank. If no COL instruction is used in the subprogram, COMPASS uses 30. 

_ , 

tO- ATiON pPEKATtCN i VAaiAflE SU3FlttOS 

- |_ 


n An absolute evaluatable expressitxi designating the column number; n > 12. 

When base is M, n ts assumed to be decimal. If n is less than 12, 
COMPASS the oohtmn s' If n is zero or blank, COMPASS se>*i 

the column to 30, the default column. 

A location field symbol, if present, is ignored. 

Example 


— 

LOCMTtON 


VA«IA»lt 

COMMENTS 

! 


II 

18 

ha 



CCL 

36 

-1- 



USE 


(RETURN TO BLOCK 0 

1 


in this example, subsequent statements for which the variable field is blank cannot have comments 
oeginning before column 36. 


-ioaaosuoc 
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4.5 BLOCK COUNTER CONTROL 


Counter control pseudo instructions establish local blocks, labeled common blocks, and blank common 
blocks in addition to the absolute, zero, and literal blocks established by the assembler; they control 
use of all program blocks, and provide the user with a means of changing origin, location, and position 
counters. 


4.5.1 USE - ESTABLISH AND USE BLOCK 

USE establishes a new block or resumes use of an already established block. The block in use is the 
block into which code is subsequently assembled. A user may establish up to 252 blocks. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBPtELDS 


USE 

block 


block 


Identifies block to be used, as follows: 


0 or blank 

// 


/name/ 


name 


* 


Nominal block (absolute or 0) 

Blank common block; for a relocatable subprogram, this block 
cannot contain data. The only storage allocation instructions 
that can follow are BSS and ORG. The BSSZ instruction is 
illegal because it presets the block to zeros. 

Labeled common block. A name can be a maximum of 7 characters 
and cannot include blank or comma. The first and last characters 
must not be colons. Conventions imposed by the loader or other 
assemblers or compilers could further restrict the use of names. 

Local block. A name can be 1-8 characters, excluding blank or 
comma. Use of this name enclosed by brackets does not cause 
the block to become a labeled common block. For example, 

USE A and USE /A/ are different blocks. 

Block in use prior to current USE, USELCM, ORG, or ORGC. 

See discussion following. 


A location field symbol, if present, is ignored. 

The nominal program block contains the entire program if no USE or USELCM is encountered. 


Redundancy between block names is permitted as follows: 

A labeled common block designated by /O/ can coexist with the program block designated by 0. 
Blank common designated by // can coexist with a labeled common block designated as ////. 
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4 CPU ’subprogram may have two blocks with the same name and the same memory type if they have 
different block types aocal or common). Furthermore, a CPU subprogram may have two blocks 
with the same name and the same block type if they have different memory types (CM/SCM or 
ECS/LCM). Thus, altogether, there may be up to four different blocks with the same name. 

svuen a o.ock is first fcslablUf-iJ, origin and location counters are zero and position counte. U 
either 6) (CPU subprogram) or 12 (PPU subprogram). V^Tien a different block than that in use is 
inaicate I, COMPASS saves the values of the current origin and position counters .along with an 
■ udicator as to whether the next instruction is to be forced upper. If the most recently assembled 
instruction unoer the block is one that forces the next instruction upper, the first instruction 
assembled upon resumption of the block is forced upper. When the designated block has been 
ureviou.dv sstCoUshed, COMPASS resumes assembly in the block using the last known values for 
the origin and position counters. The value of the location counter is not saved. Upon resumption oi 
y bli.cs : is to the value of the origin counter. If a LOG had been used previously, resetting 
f r-M '■ r ifter U; v.rod'iee f>><. desired results ;•« the responsibility of the yirogram-mer. 


The assembler records occurrences of USE, USELCM, OllG, and ORGC pseudo instructions (except 
USE * and USFLCM *) and maintains a USE table of the most recent 50 occurrences. Each USE * and 
IJC’V] * yocyav cf th'= 'Tiost recent entry and removes it from the table. When the subprogr.in- 

contains more USE '' or USELCM * instructions than there are entries in the stack, COMPASS uses 
i-he nominal block. 


E'jfamp]”' I 

Lpf’atjon Code Generate 

i? aionjCCOGO 
35 ir20‘‘0r!00nt!'100 0']0 00 Cl 

id d 1 31? Q 0 it 0 0 0 


Note that 

block. 

Location 


? 65.5 00 


Code Generated 


30002600 + 



location 

OPfSATlON 

VARIABLE 

COMMENTS 

} 


n 

IB 

Uo 

~ 


USF 


1 


GHHMa 

PJ 

ALPHA 

1 BLOCK 0 IN USE 



USE 

DATAl 

1 BLOCK (DATAl IN USE 


sap 

narft 

1.0 

1 



USE 


(RESUME USE CF BLOCK 0 



SA3 

SAM 

1 

:ause the KJ causes a force upper of the next instruction in the 

rr 

r -1 

LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


-1-. ry, 

_LL-.-— - - -- - - -—r— 



Uit 

T ABLt 

;uaE iA.eLE local blocis 

! 


VFC 

6/0 

i 



USE 

4 

iRtSUMF PREVIOUS BLOCK 




t. 


i • 

♦ 

« 

0 

i ■ 

« 

• 

, • 

i 1 

US6 

TABLE 

RESUME USING TABLE 

1 i 

VFO 

fa/lRX,18/S 


i I 

I 1 

ust 

* 

jRtSUMt PREVIOUS BLOCK 


Note how separate blocks can be used to facilitate packing of partial-word bytes into a table residing in 
a block other than the one primarily being used. 
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4.5.2 USELCM - ESTABLISH AND USE ECS/LCM BLOCK 


'I’he USEIA'M pseudo instruction establishes or resumes use of a block assigned to extended core 
storage (ECS) or large core memory (LCM). For all ECS/LCM blocks in an absolute CPU assembly, 
and for the ECS/T.CM blank common block in a relocatable assembly, data generating instructions 
(including BSSZ) and symbolic machine instructions are illegal; only storage reservation pseudo 
instructions (BSS, ORG and ORGC) are allowed. The USELCM pseudo instruction is illegal in PPU 
assemblies. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBEIEIOS 


USELCM 

block 


block: Identifies block to be used, as follows: 


0 or blank Illegal. 

// Blank common block. A subprogram can have two blank common 

blocks if one of them is in ECS/LCM. 

/name/ Labeled common block. The name can be a maximum of 7 

characters and cannot include blank Or comma. The first and last 
characters must not be colons. The loader or other assemblers or 
compilers could further restrict the use of names. 

name Local block, t The name can be 1-8 characters, excluding blank or 

comma. Use of this name enclosed by brackets does not cause the 
block to become a labeled common block. For example, A and /A/ 
are different blocks. All of the local ECS/LCM blocks are con¬ 
catenated to form a single block, which is treated by the loader as 
an ECS/LCM common block whose name is unique to the subprogram. 

* Block in use prior to current USE, USELCM, ORG, or ORGC. 

A location field entry, if present, is ignored. 

The length of each ECS/LCM block, including the combined local block, is rounded up, if necessary, 
to an integral multiple of eight 60-bit words. The maximum size of an ECS/LCM block is 1,048,568 
words. 

Further rules for USELCM are the same as for USE. 


t SCOPE 2 does not currently allow local blocks in LCM. 


4-34 


60360900A 


Exampl'^s: 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

* 


n 

18 

l30 



BASE 

0 

d- 

1 



uselck 

LCM 

[ESIABLISH and use LUM BLOCK 


LCMC 

BSS 

0 

[UEFINE SYMBOL LCMC 


BLOCl 

BSS 

100 

iRESERVE 100 MOROS 


BL.0C2 

BSS 

200 

(RESERVE 200 WORDS 



USE 

9 

• 

[RESUME PREVIOUS BLOCK 

t 



ORG 

• 

BLOCl^lOOOB 

1 

1 


BLOC 3 

BSS 

20 

[reserve 20 MORE WORDS 



USE 


jRESUME PREVIOUS BLOCK 


i 


4.5.3 (JRG AND ORGC - SET ORIGIN COUNTER 

.MiG UK irectly indtcates the block to be usea for assembly of subsequent code and specifies fee value 
to which the origin and location counfers are to be set. COMPASS makes an entry in the USE table and 
saves the current origin and position counter values. 


ORGC t Indirectly indicates the block to be used for assembly of subsequent code and specifies fee value 
to which the origin and location counters are to be set. COMPASS makes an entry in fee USE table and 
saves the current origin and position counter values. In a PPU or absolute assembly, ORGC is the 
same as ORG. In a relocatable CPU assembly, ORGC is fee same as ORG if the USE block specified 
by the address expression is not a common block; otherwise, code following an ORGC is ignored by 
fee linking loader if that common block was first declared by a previously loaded subprogram. 


t Not supported by SCOPE 2 Loader. 
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Formate; 


LOCATION 

OPEHATION 

VADIAILE SUIFIELOS 


ORG 

exp 


ORGC 



6xp Expression specifying the address to which the origin and location counters are to be 

set. Following ORG or ORGC, the assembly resumes at the upper position of the 
location specified. COMPASS determines the block as follows: 

1. If the expression contains a symbolic address, COMPASS uses the block in 
which the symbol was defined. 

2. COMPASS uses the current block if the value of the expression is *, *L, or 
*0. If the origin and location counters are the same value, and no code has 
been assembled in the current location, the only effect of *, +L, or *0 is to 
force the next instruction upper. If a word is partially assembled, however, 
the code already assembled into the location is lost. 

If the counter values differ, * or *L sets the origin counter to agree with the 
location counter value; *0 sets the location counter to the origin counter value. 

3. An absolute expression causes use of the absolute block. In a relocatable 
assembly, this is the only way to establish the absolute block. All symbols 
defined in the absolute block are absolute. 

Any symbols in the expression must be already defined in the assembly and must not result in a 
negative relocatable value. It is not possible to ORG or ORGC into the literals block. 

A location field symbol, if present, is ignored. 

Once an ORGC pseudo instruction has established the conditional loading indication for a given common 
block, it is in effect whenever assembly in that block is resumed by subsequent USE or USELCM 
pseudo Instructions, and can be cleared only by an ORG pseudo instruction specifying that block. 
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4-97 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1) 

18 

1 30 


u >!: 

/DATS/ 

1 

DATA 


0 

1 


ORGC 

DATA 



UAf A 

1,2,3 

lOONOITTONALLY DATA 

1 


U5P 

ANYDLOCK 

1 


OONI 

3RyYZ 

'unconditional DATA 


USr 

» 

1 

FOUR 

DATA 

4 

jRFTURN TO /DATA/ STILL 


DATA 

5,5 

CONDITIONALLY SKIPPING 

1 


ORG 

FOUR 

1 


ZR 

XI.ERROR 

luNCONDlTIOMALLY LOADED 


9J 

• 

• 

• 

sun4 

1 INSTRUCTIONS 

1 

1 
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4 5.4 BSS~BLOCK STORAGE RESERVATION 


The BSS instruction reserves core in the block in use by adjusting the origin and location counters. It 
does not generate data to be stored in the reserved area. A primary application is for reservii^ bl^ 
f ommon storage. It can also be used to reserve an area to receive replicated code (see REP, KEPC, 
.ind REPI, section 4. 8. 8). 


Format: 



If present, sym is defined as the value of the location counter after the force 
upper occ urs. It is the beginning symbol for the storage area. 

Absolute expression specifying the number of storage words to be reserved. 

All symbols must be previously defined; aexp connot contain external symbols. 
The value of itie expression can be negative, zero, or positive and the value 
is added to both the origin counter and the location counter. A BSS 0 or an 
ex iuaeous ";.(.■ ion causes force upper and symbol definition but no storage 
is reserved. 


Example; 
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4.5.5 LOG - SET LOCATION COUNTER 


A IjOC pseudo instruction sets the value of the current location counter to the value in the variable 
field expression. The location counter is used for assigning address values to location symbols, 
t'hanging the location counter permits code to be generated so that it can be loaded at the location 
conti’olled by the origin counter and moved and executed at the location controlled by the location 
counter. Thus, any addresses defined while the location counter is different from the origin counter 
will be correctly relocated only after the code is moved. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBEIEIDS 


LOC 

exp 


exp Relocatable expression specifying the address to which the location counter 

is to be set. Any symbols in the expression must be already defined in the 
assembly and must not result in negative relocation. 

A location field symbol, if present, is ignored. 

Following a LOC, if the value of the location counter differs from the origin counter, the location field 
is flagged with an b on the listing until a LOC *0, USE, ORG, ORGC, or USELCM instruction resets the 
location counter to the value of the origin counter. 

A LOC instruction does not cause the assembler to switch from the current block to another. LOC 
causes the next instruction in the block to be forced upper. The only effect of LOC * or LOC *L is to 
force upper. Because COMPASS does not save the value of the location counter when it switches 
blocks, a USE, ORG, ORGC, or USELCM for a different block effectively resets the location counter to 
the origin counter value. When use of the block is resumed, it is the responsibility of the user to reset 
the location counter to produce the desired results. 
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Exampl!: 


In the following example, the irst LOG is used to generate PPU code that is to be loaded into one 
PPU and transmitted to a different PPU for execution. The second LOG is used so that on the listing 
the address field contains the table ordinal rather than a load address. At the end of the table, a LOG 
instnictjon changes the location counter to resume counting under the first LOG. At the end of the 
prograre , I OC *0 returns the iocation counter to the value of the origin counter. 


Location 

Gode Generated 

7101 




%. 9 ’ 


- 5 '* 


101 

2400 

L 102 

2400 

L IQ^J 

6100 0100 


I 

L 1 

1. ') 

L t 

L 2 

L ‘5 

L H 

L S 

L 4 

( Tt 


oloa 

0114 

0121 

0132 

0136 

0147 

0240 

1000 


L 215 
L 215 
L 240 
7 240 
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4.5.6 POS - SET POSITION COUNTER 


The POS pseudo instruction sets the value of the position counter for the block in use to the value 
specified by the expression in the variable field. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 


POS 

aexp 


aexp An absolute evaluatable expression having a positive value less than or 

equal to the assembly word size (60 for CPU, 12 for PPU). A negative value, or 
a value greater than 60 (or 12), causes an error. The value indicates the bit 
position within the current word at which the assembler is to assemble the next 
code generated. Use caution, because if the new position counter value is greater 
than the old position counter value, part of the word is reassembled. (New code 
is ORed with previously assembled data.) If the new position counter value is less 
than the old position counter value, the assembler generates zero bits to the 
specified bit position. If the value of aexp is zero, COMPASS assembles the next 
code in the following word. 

A location field symbol, if present, is ignored. 


CAUTION 

If the POS instruction is used on a word containing re¬ 
locatable or external addresses, undefined results may 
occur with no diagnostics. 

The POS instruction does not alter the origin and location counters. The position counter is never 0 
at the beginning of an instruction. At the beginning of a new operation, if a data value has been 
stored into bit 0 (the rightmost bit) of a word, COMPASS increments the origin counter and the 
location counter and resets the position counter to 60 (or 12). 

A POS *P has no effect whereas a POS $ subtracts one from the counter. 


4.6 SYMBOL DEFINITION 

The p.'seudo instructions EQU, SET, MAX, MIN, and MICCNT permit direct assignment of 21-bit 
values to symbols. The values can be absolute, relocatable, or external. Register designators are 
not valid in the expre.ssions. Subsequent use of the symbol in an expression produces the same result 
as if the value had been used as a constant. In the listing of the symbolic reference table, a refer¬ 
ence to an EQU, , SET, MAX, MIN, or MICCNT instruction is flagged with a D. Symbols defined 
using EQU and = cannot be redefined; symbols defined using any of the other symbol definition 
instructions can be redefined. 
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4.6.1 IQU OR =-EQUATE SYMBOL VALUE 


An EQU or = pseudo instruction permanently defines the symbol in the location field as having the value 
and attributes indicated by the expression in the variable field. 

Formats'; 


IC'JATION 

OPERATION 

VARIABLE SUBFIELDS 

sym 

EQU 

exp 

sym 

= 

exp 


svm A locaiion symbol is required. See section 2.4 for symbol requirements. 

exp An evaiuataote expression. Any symbols in the expression must be previously 

defined or declared as external. The expression cannot contain symbols 
prefixed by or = X unless the symbols have also been defined conventionally. 
If the expression is erroneous, COMPASS does not define the location symbol 
but flags an error. 

Examples: 




LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


) 


n 

18 

Uo 

20437 



= 

20437B 

1 

74 


LINP 

= 

74B 

1 

3 


CH 

EQU 

3 

1 

74 


PfSGf SIZ 


LINP 

1 

& <: 2 7 1 ! 

IGOPS 

EOJ 

! ♦-OPS 

1 


I I 
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4.6.2 SET - SET OR RESET SYMBOL VALUE 


A SET pseudo instruction defines the symbol in the location field as having the value and attributes 
indicated by the expression in the variable field. A subsequent SET using the same symbol redefines 
the sjrmbol to the new value and attributes. SET can be used to redefine symbols defined by SET, MAX, 
MIN, or MICCNT, only. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 

sym 

SET 

exp 


sym A location symbol is required. See section 2. 4 for symbol requirements. 

exp An evaluatable expression. The expression cannot include symbols as yet 

undefined and cannot contain symbols prefixed by =S or =X unless the symbols 
are also defined conventionally. 

If the expression is erroneous, COMPASS does not define the symbol but 
issues a warning flag. 


The symbol in the location field cannot be referred to prior to its first definition. 
Examples: 


17 

74 

22 

76 

24 


20 
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4.6.3 AiAX ~ SET SYMBOL TO MAXIMUM VALUE 


Tne MAX pseudo instruction defines the symbol in the location field as having the value and attributes 
indicated by the largest (most positive) value of the expressions in the variable field. A subsequent 
SET, MAX, MIN, or MICCNT using the same symbol redefines the symbol to the new value. 

-nveicF ily MAX caa be J tr. redefine symbols defined by these instructions. 

Format: 



OPERATION 

VARIAeiE SUIFIEIDS 

syrn 

' 

MAX 

exp^,exp2,...,exp^ 

. 


A ioeation neid symbol is required. See section 2.4 for symbol requirements, 

e-.Tp. An evaluatable expression. Any symbols in the expression must be previously 

defined. Ttie expression cannot contain symbols prefixed by =S or =X unless 
the symbols are also defined conventionally. 

l iie e.'ipresrtions should have sim.ia * attributes. No test is made for attributes. The test for maximum 
value is made in pass one. I.n testing for the maximum value in pass one, COMPASS uses values for 
relocala ile syitiibols relative to block origins. 


NOTE 

During pass two, the expression selected in pass one is 
used. The relocatable symbols have been reassigned 
values relative to program origin and these values are 
used for the final value of the expression selected in the 
first pass. 

!i 'di\y of the exfiressions are erroneous, COMPASS does not define the symbol but issues a warning fiag. 
The symbol in the location field cannot be referred to prior to its first definition. 





LOCATION 

OPERATION 

VARIABIE COMMENTS 

IT 


11 

!8 |30 

i 

! 

f- T Z 

FT 41 

PT32 

SYM 

EQU 

EQ’J 

HAX 

5 

b 1 

2 1 

PT3,PT31,PT32 

1 


ft p ey p f\ ^ ^ 
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4.6.4 MIN - SET SYMBOL TO MINIMUM VALUE 


A MIN pseudo instruction defines the symbol in the location field as having the value and attributes 
indicated by the minimum or least positive value of the expressions in the variable field. A subsequent 
SET, MAX, MIN, or MICCNT using the same symbol redefines the symbol to the new value. 
Conversely, MIN can be used to redefine symbols defined by these instructions. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 

sym 

MIN 

63^2 9 ®Xp2 » • • • » 


sym A location symbol is required (section 2.4). 

exp. An evaluatable expression. Any symbols in the expression must be previously 

^ defined. The expression cannot contain symbols prefixed by =S or =X unless 

the symbols are also defined conventionally. 

The expressions should have similar attributes; no test is made for attributes. 

The test for minimum value is made in pass one. In testing for the minimum value in pass one. 
COMPASS uses values for relocatable symbols relative to block origins. 

NOTE 

During pass two, the expression selected in pass one is 
used. The relocatable symbols have been reassigned 
values relative to program origin and it is these values 
that are used for the final value of the expression which 
was selected in the first pass. 

If any of the expressions are erroneous, COMPASS does not define the symbol but issues a warning 
flag. 

The symbol in the location field cannot be referred to prior to its first definition. 
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4.6.5 /4ICCNT-SET SYMBOL TO MICRO SIZE 


The MICCNT pseudo instruct on defines the symbol in the location field as having a value equal to the 
number of characters in the value of the micro named in the variable field. A subsequent SET, MAX, 
MIN,. or MICCNT using the same symbol redefines the symbol to the new value. Conversely, MICCNT 
can be used to redefine symbols defined by these instructions. 

} ormat 



n A locaaon symbol is required (SscUon 2.4). 


mname Name of a previously defined micro; it may be a system micro or may have 

been defined through MICRO, OCTMIC, DECMIC, or BASE. If mn a m e has 
not been previously defined, the location symbol is not defined (or redefined) 
and a warning flag is Issued. 


Example: 


6 


E3 



I IrtSG MICRO 

I jllSIZE MICCNT 


Itt’ALPHfiNUHERrC 19 CHAR. MICRO 

MSG ImSIZE equals 19 
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4.6.6 SST - SYSTEM SYMBOL TABLE 


An SST pseudo instruction defines system symbols, with the exception of the symbols noted, as if the 
symbols had been defined in the subprogram. 

rhe symbols are in a system text overlay accessed from a library or file through the S or G list 
options on the COMPASS control statement (Section 10.1.2). 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 


SST 

sym^,sym2,... ,sym^ 


symj One or more symbols on the file that are not to be defined. 

A location field symbol, if present, is ignored. 

Refer to section 4. 3.4 for an example of use. 


4.7 SUBPROGRAM LINKAGE 

Pseudo instructions ENTRY, ENTllYC, and EXT do not define symbols but either declare symbols 
defined within the subprogram as being available outside the subprogram or declare symbols referred 
to in the subprogram as being defined outside the subprogram. 
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4.7.1 fNTRY AND ENTRYC - DECLARE ENTRY SYMBOLS 


The ENTRY pseudo instruction specifies which of the symbolic addresses defined in the subprogram 
can be referred to by subproj^rams compiled or assembled independently; ENTRY lists entry points to 
the current subprogramo ENTRY is illegal in PPU assemblies. 

rhe ET'I'R /C t pseudo instrjction ; .onditionally specifies which of the symbolic addresses deftnec is. 
the ssuborograra can be referred to by subprograms compiled or assembled independently; ENTR C 
lists Cl nditional entry points to the current subprogram. ENTRYC is illegal in PPU assemblies md 
IS svncnymous with ENTRY in absolute CPU assemblies. In a relocatable assembly, an entry point 
symbol declared by ENTRYC is ignored by the linking loader if the value of the symbol is relative to a 
commc-i block and that common block was first declared by a previously loaded subprogram. 

F onri a* s: 


1 

i 

-- 1 

OFBATiON 1 

VAiilASLt SljBFltLDS 


ENTRY 

sym^, sym2, .... sym^ 


ENTRYC 

■ 1 

1 

sym^, sym^, ..., sym^ 


sy :. Linkage symbol; 1-7 characters of which the first must be alphabetic (A-Z) and the 

^ last must not be a colon. The symbol cannot Include the following characters: 

+ - * / blank , or A 

Each symbol must be defined in the subprogram as nonexternal (cannot begin with 
=-X or be listed on an EXT pseudo instruction). Entry point symbols must be un¬ 
qualified (Section 2.4.5). 

rt 'icx.-ation symbol, if present, Ls ignored. 

n.'i r.f ail ecitry points declared ta the subprogram pre.;edes the assembly listing. An asterisk 
appears to the right of each conditional entry point. 


(Not supported by SCOPE 2 Loader, 
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Example: 


Location C ode Generated 


110 

110 

in 5120000 1 0 0 

7^720 

111 5110000002 



4.7.2 EXT - DECLARE EXTERNAL SYMBOLS 

The EXT pseudo instruction lists symbols that are defined as entry points in independently compiled 
or assembled subprograms for which references can appear in the subprogram being assembled. 

'The EXT pseudo instruction is illegal in an absolute subprogram. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIOS 


EXT 

sym , sym ,.,., sym 
i ii n 


Linkage symbol, 1-7 characters of which the first must be alphabetic (A-Z) and the 
last must not be a colon. The symbol cannot Include the following characters; 

+ - * / blank , or a 

These symbols must not be defined within the subprogram. External symbols 
are unqualified. 

A location field symbol, if present, is ignored. 

An extei’nal reference is flagged with an X in the address field in the listing of code generated. All 
external symbols are listed in the header information for the assembly listing. 
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4.8 D ^TA GENERATION 


The instructions described in this section are the only pseudo instructions that generate data. All 
other program data is generated through symbolic machine instructions. An instruction that 
v%uierair 3 data cannot be used in a blank common block. The pseudo instructions that generate data 

are: 


B:>SZ 

bl ink operation field 

D/l TA 

DIS 

I/'T 

V "D 

RI P, RFPC, or REPI 


Generates zeroed words 

Generates one zeroed word 

Generates one or more words of data 

Generates one or more words of data 

Generates literals block entries 

Places expression values in user-defined fields 

Places express'or values in hill words 


For use in macros; R= assumes that either (Bl)=l or (B7)=l and 
generates increment instructions accordingly 

Does not actually generate object code at assembly time but 
causes the relocatable loader to repeatedly load a sequence of 
code into a reserv'ed blank storage area. 


4.S.1 ZSSZ /..MD BLANK OfilRATiON FiELD—RESERVE ZEROED STORAGE 

The BSI51 iasti uction reserves zeroed core in the block in use. The origin and location counters are 
adjusiOG by che requested number of words and the assembler generates data words of zero to be 
loaded into the reserved area. An instruction that contains a symbol in the location field but has a 
blank operation field has the same effect as a BSSZ of one word. 


-.'t/i. A t M...IN ' 

!opeiat.on 

* A Bit Suo''f iDS 

sym 

i 

BSSZ 

i : 

j 

■ 

afjxp 

i 


V'n If yi’esenr,, sym is dcfiaed as tiu' vaioe of the locaUon counter after the force 

upper occurs. The symbol identifies the beginning of the reserved storage area. 

aexp Absolute evaluatable expression specifying the number of zeroed words of 

storage to be reserved. The expression cannot contain external symbols or 
result in a relocatable or negative value. 

A BSSZ 0 or an erroneous expression causes a force upper and ssrmbol definition but no storage is 

reserved. 
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A BSH/ or }> I'oii]) of BSSZ instructioiiK of six or more words produces an REPL table in object code to 
reduce the physical size of the object program (appendix B). 

Only the first word appears on the listing. 


4.8.2 DATA - GENERATE DATA WORDS 


The DATA pseudo instruction generates one or more complete 60-bit or 12-bit data words in the 
current block for each item listed in the variable field. 


Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIDS 

sym 

DATA 

itemj^, item2, • ••, item^^ 


,sym If present, sym is assigned the value of the current location counter after 

the force upper occurs. It becomes the symbolic address of the first item 
listed. 

item. Character, octal numeric, or decimal numeric data item, according to 

specifications described in section 2.7. Floating point notation is illegal in 
PPU assemblies. Items are separated by commas and terminated by a blank. 

A literal cannot be used as an item. 

A DATA pseudo instruction always forces upper. A blank item does not cause generation of a data word. 


Unless the D list option is selected, only item^ appears on the listing. 


Examples: 


Location Code Generated 


\ LOCATION 

OPERATtOTJ 

VARIABLE COMMENTS 



} 


11 

18 Uo 

55? 

14071700000000000000 


OPTB 

DATA 

i-—j- 

OLLGO 1 

553 

40O00OOC0O0OOO000000 


OPT 

DATA 

lBS5q 1 

554 

03171520111405000000 


OPTT 

DATA 

OLCOMPILE 1 

555 

17252420252400000000 


OPTO 

DATA 

OLOUTPUT.O 1 

556 

OOOOOOOQOOOQOOOOOQOO 




1 

557 

17205146314631463146 


OPTY 

DATA 

1.3EE 1 


56(1 16403146314631463146 
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Locatioi 


i25R 

1251 

1252 

1253 
i25U 

1255 

1256 
125f 
1260 
1261 
126 2 


Code Generated 

— 

LOCATION 

OPtSATION 

VAIIABIE COMMENTS 


1 


11 

18 |30 


” 


PERIPH 

--^- 

1 

D.*0 



Base 

0 ' 

1 




• 

• 1 




• 

• 

ro7o 


Ut 

DATA 

7070,-7,0,lRi 

7770 




1 

0000 




1 

0 0 34 




1 

5501 



DATA 

2C A.OLEF 

0000 




1 

0506 




1 

0123 



DATA 

]123,-4 1 

7773 





0401 



DATA 

^»0ATA♦ 1 


2401 


4.8.3 DIS—GENERATE WORDS OF CHARACTER DATA 


The DIS aseudo instruction generates words containing character data. The instruction can be used 
conveniently when a character data string is to be used repeatedly. Unless the D list option is selected 
only the first word of character data appears on the listing. The instruction has two formats: 


Format one: 





lOCATION 

OPERATION 

VARIABLE SUBFIEIOS 

sym 

DIS 

n, string 


sym If present, sym is assigned the location counter value after the force upper 

occurs. It is the symbolic address of the first word containing the character 
string. 

n An absolute evaluatable expression specifying an integer number of words to be 

generated. When base is M, COMPASS assumes that n is decimal. 

string Character string 

For a CPU program, COMPASS takes 10 times n characters from the string and packs them as they occur 
10 characters per word into n words. For a PPU program, COMPASS takes two times n characters froin 
the string and packs them as they occur two characters per word into n words. If the statement ends 
before 10 x n (or 2 x n) characters, the remainder of the requested words are filled with blanks. 

If n is 0, COMPASS assumes the instruction is in format two. 
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Format two: 


LOCATION 

OPERATION 

VARIABLE SUBPIELDS 

sym 

DIS 

,dstringd 


sym If present, sym is assigned the location counter value after the force upper 

occurs. It is the symbolic address of the first word containing the character 
string. 

d Delimiting character 

string Character string; any character other than delimiting character 

In this form, the string must be bounded by delimiters. The comma is required. The characters between 
the two delimiting characters are packed into as many CPU or PPU words as are needed to contain them. 
I'welve zero bits are guaranteed at the end of the character string even if COMPASS must generate an 
additional word for them. If COMPASS detects the end of the statement before it detects a second 
delimiting character, it produces a fatal error. 


Examples: 


Location Code Generated 


lOCAIION 

operation 

VARIABLE 

COMMENTS 



1 


n 

18 

|30 


561 

562 

07051605220124055535 

55032025552717220423 


ONE 

OIS 

2, GENERATE 

?l'cPU 

1 

WORDS 

563 

564 

565 

07051605220124055535 

55032025552717220423 

oooooooooooooooooooo 


TWO 

DIS 

♦•GENERATE 

2| CPU 

1 

1 

WORDS* 
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Locati f)n 

Code Generated 



LOCATION OPEIIATION VARIABLE COMMENTS 




1 

II IB Iso 





PPJ ' 

) 



Q r* M 


BASE « ‘ 

:i t- 

i'?C5 



!-'In 1 0 T lEiitRA r t lu PP Hi OP ill 

i,: J 





I f 0 n 

2201 



( 

140 5 

2405 



1 

140b 

5534 




140/ 

3 35 5 




.1410 

2020 



1 

14 11 

5 32/ 


J 

1 

1412 

1722 


j i 

14 :j 

0 4 2 3 


1 I 

4 

:j ? 0 5 


ibis ,*GENtPATt 10 PP POKDS* 

r ' 

iil 

i 

i ; 

141/ 

2405 


1 

:l.4?n 

■==534 


1 

i 4 ?' , 



1 

I'+crt: 

2020 


i 

142 3 

5527 


1 

i. ->24 

1 ,’2'2 



t 4 ? 

0 32 3 

1 

1 ■ 


f.cOO 




4.8 4 IT-declare literal VALUES 

*, I JT eudu instruction generate;s data words in the literals block. This instruction and the 
= prefix to a data item provide the onlj means of generating data in the literals block. The LIT 
p,’- ■"jt'-;- Instractior, assures sequential entries for a table of values. 

" '>'r: 

jsyin jLIT |item.|^, item2,.. •, item^ 


-vin [f present, sym is assigned the value of the literals block location counter 

iteiTij At least one and not more than 100 words of character, octal numeric, or 

decimal numeric data items. Section 2.7.3 contains specifications. Items 
are separated by commas and terminated by a blank. Floating point data 
items are illegal in PPU assemblies. 
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COMPASS enters data items into the literals block in the order specified. 

If the converted binary values for all the data items listed with a single LIT match an existing literal 
block sequence, they are not duplicated. If, however, any item in the list does not match an entry in 
the block, the entire sequence is generated. A literal item subsequently referred to through an 
= prefix is not duplicated. A null item (e.g. H+* or OL) does not cause a word to be generated. 

Examples: 


Location Code Generated 

r 

h- 

LOCATION 

OPeRATlON 

VASIABIE COMMENTS 


1 


n 

18 130 

611 


POOL 

LIT 

3.1,1.59265,2.7192182,57.2957795EE1 


CONIF^T CF LITFPfiLS BLCCK. 
000611 17216146314631463146 00f“Y-Y~Y- 
000612 17206275576441776271 0P1>.^6;1* 
000613 17215337351136014426 0Q?4?I3A9V 
000614 17314363651440663121 0Yati»L5vYQ 
000615 16513333033540576566 N(OOC25.,.v 


Location Code Generated 


LOCATION 

OPERATION 

VARIABLE COMMENTS 


1 


II 

18 |30 

7447 


N2 

LIT 

lRl,7070,7,ol 

7453 



LIT 

?C A,0LEF 1 

7456 



LIT 

H*LITERALS* 1 


CCNIFNT CF LITFRALS BLOCK. 


7447 0034 

7450 7070 

7451 0007 

7452 0000 

7453 5501 

7454 0000 

7455 0506 

7456 1411 

7457 2405 

7460 2201 

7461 1423 


1 

G 

A 

FF 

LI 

TE 

RA 

LS 
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4.8.5 VrD-VARIABLE FIELD DEFINITION 


The VFD instruction generate ; data in the current block by placing the value of an expression into a 

field of the specified size. 

Fornnat 


K-CAT ION 


OfSIATlON 


VASIaBIE SUBfIElDS 


S’! m 


VFD 


itemj^/expj,item2/exp2,. •. .itenijj/expjj 


For a CPU assembly, the location field can contain sym, plus, minus, or 

blftrsk, aii foliows; 

If a symbol is provided in the location field, a force upper occurs 
and the value of the location counter following the force upper is 
assigned to the symbol. The s 5 rmbol Identifies the first word of 
data generated by the VFD. 

Causes a force upper. Data generation begins in a new word. 

COMPASS generates zero bits to the next quarter word boundary, 
at which point the first field begins, 

COMPASS begins the first field at the current value of the position 
counter. 

For a PPU assembly, if the location field contains a plus, minus, or a symbol, 
data generation begins in a new word. If the location field is blank, the first 
field bfcg;r.i- :.i the current value of the position counter. 

item. An unsigned constant or previously defined symbol having a value specifying a 

pu n . r : i-ct namUr c-f bPs r ib.e field to be generated; maximum field 
sue u ft' bitf for both CPU and PPU assemblies (60 being the maximum 
number of significant bits for an expression value). When base Is M, item^ 
is assumed to be decimal notation. 

expj An absolute relocatable or external expression, the value of which will be 

inserted into the field specified by itemj. The expression is evaluated using 
the specified field size Character constants are right or left adjusted in the 
field according to the ts'pe of iusufication indicated. In a relocatable CPU 
assembly, no field that ccntams a relocatable or e.xtriTial address expression 
can cross a 60-bit word boundary, and no 60-bit word can have more than 
four fields tliat contain relocatable or external address expressions. 


sym 


blank 


Each iieid is generated as it occurs. For a CPU assembly, if the next instruction that generates code 
in the block is not a VFD with a blank location field, and the last VFD field in the current VFD ends to 
the left of a quarter word boundary, COMPASS inserts zero bits up to the next quarter word boundary. 
These zero bits do not show on the assembly listing. Remaining parcels are then filled with no- 
eperation iastr>actlons. 
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Wlien a VFD instruction that does not have a location field entry immediately follows another VFD in 
the same block, no padding with zeros or forcing upper occurs; fields are generated sequentially as 
they are specified. 

Following a VFD, the position counter contains the number of bits remaining to be assembled in the 
last word in which data was generated by the VFD. 


Examples: 


Location 

Code Generated 


LOCATION 

OPERATION 

VARIABLE COMMENTS 



1 


n 

le |30 






1 


31 


ALPHA 

SET 

25 1 

566 24010200000023000551 


TABLE 

VFO 

36/3CTAB,6/l'9,18/TABL0C 

567 00000005665555555555 



VFO 

30/*-l,30/5H ,ALPHA/-0 

570 777777774 




1 


OOOQOOOQOOOO 



VFQ 

*?/ 1 

571 11172401550155555531 



VFO 

30/0HIOTA,6/lRA,24/0AX+l 

572 00000015052323010705 



VFD 

60/nRMESSAGE,30/3LCIO, 15/ORO 

573 031117000000033 1 




1 

Location 

Code Generated 


LOCATION 

OPERATION 

VARIABLE COMMENTS 



1 


n 

18 i 30 











PPU 

1- 


Oi*M 



BASE 

M 1 

1310 

3334 


N4 

VFD 

60/10R0123456789 

1311 

3536 




1 

1312 

3740 




1 

1313 

4142 




1 

1314 

4344 




1 

1315 

0010 


All 

VFO 

12/10,12711,12/-12,127-7070 

1316 

0011 




1 

1317 

7765 





1320 

0707 






4.8.6 CON - GENERATE CONSTANTS 


rhe CON pseudo instruction generates one or more full words of binary data in the block in use. It 
differs from DATA in that it generates expression values rather than data items and differs from VFD 
in that the field size is fixed. 


Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIDS 

sym 

CON 

exp^,exp2,...,exp^ 


sym If present, sym is assigned the value of the location counter after the force 

upper occurs. 


exp. 


An absolute, relocatable, or external expression the value of which will be 
inserted into a field having a size of one word. For PPU assembly, floating 
point is not allowed; for CPU assembly, double precision is not allowed. 
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Examples: 


Location 

Code Generated 


lOCATION 

OPCIATION 

VARIABLE 

COMMENTS 




1 


II 

18 

Uo 


1 (kb” 

0000 

— 

MSRI 

C6N 

0 

1 


1461 

0006 



Ca\' 

6 

1 



0003 



CON' 

3 

j 


146? 

??04 



CON 

FAIL 



146 1 

00?4 



CON 

?0 

1 


1 46 

0000 


mSr? 

roN 

0 



1466 

0006 



CON 

6 

1 


1 46 7 

00 03 



CON 

3 

I 


147.1 

? 177 > 



CON 

PASS 

1 


1471 

00?4 



Con 

?0 

1 



Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 



1 


II 

18 

ho 

.. 

7 i 



Tftn 

PS5 

0 

f.- 


9 




LOC 

0 

1 

.00 


n 

00000000000000000055 



CON 

IR 


i 

0000900000000000006? 



CON 

IRl 

01 



00000000000000000064 



roN 

IR# 

1 0? 


3 

OOQOOOOOOQOOOQ00006Q 



TON 

• 

1R = 

• 

1 03 

1 • 


75 

00000000000000000066 



• 

CON 

• 

IR* 

i 75 


76 

00000000000000000076 



CON 

IR’' 

1 


7 7 

00000000000000000055 



j CON 

IP 

1 


67% 




1 LOC 

♦0 

1 



4.ij,7 K ^ _ CONDITIONAL INCREMENT INSTRUCTION 


The R-- pseudo instruction generates a CPU increment unit instruction depending on the contents of the 
v.tdaijie subfieids and on whether or not the subprogram earlier contained a Bl=l or B7=l pseudo 
in-rtruction (Section 4.4.4). 

rii:' oi .Juginents macro definitions and increases optimization of object code. It is illegal in a 
PPU program. 


The A list option controls listing of substituted instructions. 


Format: 


■o'':at>on 

r 1 

!OPESATiON 1 

fvARIABlE SUBFIEIDS 

sym 

R= 

reg.exp 


Optional, if present, sym is assigned the value of the location counter after 
the force upper occurs. This force upper occurs whether the R= generates an 
instruction or not. 
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reg A register designator (A, X, or B) and a digit (0-7) which COMPASS 

concarenates with S to form the instruction operation code. 

exp Operand register or value expression. If the second subfield is the same two 

characters as reg, no instruction is generated. 

If the expression value is 0, the variable field is BO. 

If the Bl=l instruction has been assembled prior to this instruction and the 
expression value is 1, 2, or -1. the ^-ariable field of flie Instruction is Bl, 
Bl+Bl, or -Bl, respectively. 

If the B7=l instruction has been assembled prior to this instruction and the 
expression value is 1, 2, or -1, the variable field for the instruction is B7, 
B7+B7, or -B7, respectively. 

In all other cases, the variable field is the register or value indicated by the 
expression. 

Examples: 


1. R= used with Bl=l 



2. Rf used with Bl?^! 
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3. Expression is same as register designator: 



LOCATION 

OPEtATION 

variaile 

COMMENTS 

1 


11 

18 

|30 






RFG 

MICRO 

R:= 

l, 

1 

i 

1 


No instruction is generated; SB5 B5 would be a no operation instruction. 

4.8.8 Rr:P., REPC, AND REPI - GENERATE LOADER REPLICATION TABLE 

T ; ' , and REPI instructions cause the assembler to generate an REPL loader table so 
' 'ir:: ■ ■ f- 6 h^iing s.^sesibleo in loaded, the loader will load one or more copies of a 

iCiia sequence. For the REPI instruction, the loader generates the copies immediately upon encoun¬ 
tering the table; for REP, the replication takes place at the end of loading. For REPC'’‘the loader 
Ipoi t *. v ie ? EPL tatPe if the desttnatjon data address is in a common block that was first declared 
tjy a previously loaded subprogram; otherwise, the loader generates the copies immediately upon 
encountering the tables. 

vcpuca ti .n of object code is valid In relocatable assemblies only. It Is particularly useful for setting 
one or more blocks of storage to a given series of values or for generating tables. 

k-teta to hi replicated must not contain any external references or common block relocatable addresses. 
■K’or RFPC and REPI, data must be Inprevlously assembled text. 

Format: 



OfERATtON 

Ua*!*-!.? SUEflELDS 

1 

REP 
REPC t 
REPI 

j 3/saddr, D/daddr, C/i‘ep, B/lbsz, I/inc 

( 

1 


Ir^cattoE field «ymbol, if present, is ignored. 

The variable field subflelds can be in any order. 

b s&ddr Relocatable e.Kpresslon specifying first word address of code to be copied. 

ilie b/saddr auofield inusi be provldea. if it is iero, or emitted, the assembler 
flags the instruction as erroneous and does not generate an REPL loader table. 

D/daddr Relocatable expression specifying the destination of the first word of the first 

copy. If D/daddr Is omitted, the assembler sets daddr to zero, and, when 
daddr is zero, the loader uses saddr plus bsz for the destination address. 

Note that room for the repeated data must be reserved in the destination block. 


* Not supported by SCOPE 2 Loader. 


60360900 D 


4-61 


Absolute expression specifying the number of times code is to be copied. When 
base is M, COMPASS assumes that rep is a decimal value. If C/rep is 
omitted, the assembler sets rep to zero. When rep is zero or one, the loader 
makes one copy. 

Absolute expression specifying the number of words to be copied (block size). 
When base is M, COMPASS assumes that bsz is decimal. 

if B/bsz is omitted, the assembler sets bsz to zero. When bsz is zero or one, 
the loader copies one word. 

Absolute exijression specifying the increment size in words. When base is M, 
COMPASS assumes that inc is in decimal. 

The increment size is the number of words between the first word of each copy. 
When inc is zero or omitted, the loader uses bsz as the increment size. The 
loader writes the first copy starting at daddr, the second starting at daddr+inc, 
the third at daddr < 2 x inc, etc. until the rep count is exhausted. 

The origin and location counters for the block containing the daddr are not advanced by a value of 
inc X rep. Storage reservation for replicated code is the responsibility of the user. 

Rules for repliciition: 

1. The S subfield cannot be omitted 

2. Room must bo reserved for the copies in the destination block (for example, through 
ORG, ORGC, or BSS) 

.‘5. RKP, REPC, and RE Rl can be used in relocatable assemblies only 

4. Data to l)e replicated must not contain any external references or common block relocatable 
addresses 

5. For REPC and REPI, data must be in previously loaded text 


C/rep 


B/bsz 


1/inc 


Example: 


Location Code Generated 


lOCATION 

OPERATION 

VARIABLE COMMENTS 

I 


n 

IB |30 

__ _ ^ __ _ 

5017 00000000000000000015 

50?0 00000000000000000020 

5021 00000000000000007070 

5022 00000000000000000001 

5023 00000000000000000005 

5024 17216300000000000000 

13 

5251 


PC 

BB 

I 

OB 

USE 

DBTB 

EQU 

USE 

RSS 

USE 

_ 1 . 

NEWR 1 

15,20,70708,1,5,3.14 

1 

1 

1 

*-BBb-5 ' 

□BLOCK 1 

RC*T 1 




REPI 

S7Bfl,D/‘OB,B/I-5,C/RC,I/I 
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4.9 CONDITIONAL ASSEMBLY 


The following pseudo instructions permit optional assembly or skipping of source code. A special form, 
SKIP, causes unconditional sk-pping. COMPASS provides IF test instructions that: 

Test for r-ssembly environment tIFtype) 
i';, Viprog vg’ue:, of two oppressions (IFop) 

Co npare values of two character strings (IFC) 

Te 5t the attribute of a single symbol or an expression (IF) 

Test the sign of an expression (IFPL and IFMI) 

I-omed'.htely fcillov-ing the test instruction are instructions that are assembled when the tested cone ition 
true j«nd skipped when the condition is false. Skipping is terminated either by a source statement 
po'rxt cn the IF instruction, or by an ENDIF, an ELSE, or an END. 

f :: ; vj :c at, m hen u.sedj i? decremented for instruction lines only; comment line.s (identified by 

:ri c J. inn one) are not counted. Determining the IF range with a statement count produces slightly 
faster arsemblv than using the ENDIF. 

rht icsa its of an IF lest are determined by the values of expressions in pass one; the value of a 
reiocataile symbol is relative to the USE block in which it was defined. The value of an external symbol 
0 u if f-e svjnMol A^as declared as external. If the symbol was defined relative to a declared external, 
lU:. vav.w- .8 the relative value. 


.,..9 1 EMDiF - END OF IF RANGE 

ip ENTilF causes skipping to terminate and assembly to resume. When the sequence containing the 
ENDIF is being assembled, or is controlled by a statement count, the ENDIF has no effect other than 
to be included in the count. 

Ivvoped snstioictions such as macro references are not expanded. Thus, any ENDIF that would have 
retailed from an expansion is not detected. 


1,5 


ifcar-'’e 




OPE«ATION 


VARlAStF 5U8FIEIDS 


! ENDIF 


fCa:ur.€; Name of an IF, SKIP, or ELSE sequence; or blaiik 

Skipping of a sequence initiated by an IF, SKIP, or ELSE that is assigned a name can be terminated 
by an ENDIF specifying the sequence by name, or by any unnamed ENDIF. Any ENDIF terminates 
skipping- of an unnamed sequence that is not controlled by a source line count. A named ENDIF 
terminates the named IF, SKIP, or ELSE and any unnamed IF, SKIP, or ELSE sequences in effect 
that are not under line count control. 
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4.9.2 ELSE - REVERSE EFFECTS OF IF 


Through the EIjSE instruction, COMPASS provides the facility to reverse the effects of an IF test 
within the IF range. An ELSE detected during skipping causes assembly to resume at the instruction 
following the ELSE. An ELSE detected while a sequence is being assembled initiates skipping of source 
code following the ELSE. Skipping continues until: 

1. A statement count specified on the ELSE is exhausted 

2. A second ELSE is detected for the sequence 

3. An ENDIF is detected for the sequence 
Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 

ifname 

ELSE 

fnct 


ifname Name of an IF, SKIP, or ELSE sequence, or blank. 

fnct Optional absolute evaluatable expression specifying integer number of source 

lines to be skipped. It has no effect if the ELSE resumes assembly. When the 
base is M, COMPASS assumes that fnct is decimal. 

An ELSE specifying the sequence by name or any unnamed ELSE terminates skipping of a sequence 
initiated by an IF, SKIP, or an ELSE that has an assigned name. Skipped instructions such as macro 
references are not expanded; any ELSE that would have resulted from the expansion is not detected. 


4.9.3 IFTYPE - TEST OBJECT PROCESSOR TYPE 

IFtype pseudo instructions test for the type of processor that will execute the object program, as 
declared by MACHINE, and PERIPH or PPU pseudo instructions. 

Format: 


LOCATION 

OPERATION 

VARIABIE SUBFIEtDS 

ifname 

IFtype 

fnct 
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ifna ne 
tj'pe 


Optional 1-8 character name. 

Mnemonic specifying type of object processor. 

Type Condition Causing Assemoly 

CP Any central processor unit 

Neither PERIPH nor PPU nor MACHINE 7 has been 
specified. That is, CPU code is assembled for a CYBER 
70/Model 72, 73, or 74 or 6000-Series Computer ^stem. 

Neither PERIPH nor PPU nor MACHINE 6 has been 
specified. That is, CPU code is assembled for a CYBER 
70/Model 76 or a 7600 Computer System. 

Any peripheral processor unit 

One of the following is true: 

1. PERIPH has been specified but MACTINE 7 
has not been specified. 

2. PPU and MACHINE 6 have both been specified. 
That is, PPU code is assembled for a CYBER 
70/Model 72, 73, or 74 or a 6000 Series Computer 
System. 

One of the following is true: 

1. PPU has been specified but MACHINE 6 has not 
been specified. 

2. PERIPH and MACHINE 7 have both been specified. 
That is, PPU code is assembled for a CYBER 
"Oy'Mcdel 76 or a 7600 Computer System, 


CP6 

CP7 

PP 

PP6 


PP7 
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Optional absolute evaluatable expression specifying an integer count of the 
number of statements to be skipped. When base is M, COMPASS assumes 
that fnct is decimal. 

The ifname and fnct parameters are related as follows: 

1. If a count is supplied, it takes precedence over any ENDIF but not over an ELSE. The only 
effect of an ENDIF in a count controlled sequence is to be included in the count. Skipping 
terminates when the count is exhausted or when an ELSE with a matching or blank name is 
encountered, whichever occurs first. 

2. If neither a count nor a name is supplied, the IF range is terminated by the first ENDIF or 
ELSE encountered, whether named or unnamed. 

3. K a name but no count is supplied, the IF range is terminated by an ENDIF or ELSE with a 
matching name or by an unnamed ENDIF or ELSE. An ENDIF or ELSE with a name that 
does not match has no effect. 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE COMMENTS 


1 


11 

ts |30 




TTENT 

XY7 1 




MACHINE 

• 

6 1 

C 



• 

BSS 

1 

12 0 1 





? i 

173 QIJOGOOOOG 



XJ 

1 




ELSE 

1 ' 




M J 

0 1 

1 
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4.9.4 !F()P-COMPARE EXPRESSION VALUES 


An IFop pseudo instruction con pares the values of two expressions according to the relational 
mnemonic specified and assembles instructions in the IF range when the comparison is satisfied. 


mat- 


LCCA^ ION 

OPERATION 

VAR’AfilE SUBfiElOS 

ifnarae 

IFop 

expj^,exp2,fnct 

1 1 

ifnan-e 

Ctotional 

I-8 character name 

■..^p 

Specifies 

comparative test: 


op 

Condition causing assembly 


EQ equality, the e.xpressions are equal in all respects. That is,they 

not only have the same numeric value but have the same attributes 
as well. For example, both are names that are common 
relocatable, or absolute,or external, etc. 

NE Inequality, the expressions are not equal in all respects. They 

differ in value or in some attribute. 

GT The first expression is greater in value than the second expression. 

No other attributes are tested. 

GE The first expression is greater than or equal in value to the second 

expression. No other attributes are tested. 

LT 'ihe first expression is less in value than the second expression. 

No other attributes are tested. 

L£ The first expression is less than or equal in value to the 

second expression. No other attributes are tested. 

For these tests, positive zero and negative zero are equal. 
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exp. An expression. When the value of exp is tested, exp can include only previously 

defined symbols and the result can be absolute, relocatable, or external. If an 
undefined symbol is used, the expression value is set to zero, the IF instruction 
is flagged as erroneous, and assembly continues with the next instruction. 

fnct Optional absolute evaluatable expression specifying an integer count of the 

number of statements to be skipped. When base is M, COMPASS assumes 
that fnct Is decimal. When fnct is blank, the comma can be omitted. 

The ifname and fnct parameters are related as follows: 

1. If a count is supplied, it takes precedence over any ENDIF but not over an ELSE. The only 
effect of an ENDIF in a count controlled sequence is to be included in the count. Skipping 
terminates when the count is exhausted or when an ELSE with a matching or blank name is 
encountered, whichever occurs first. 

2. If neither a count nor a name is supplied, the IF range is terminated by the first ENDIF or 
ELSE encountered, whether named or unnamed. 

3. If a name but no count is supplied, the IF range is terminated by an ENDIF or ELSE with a 
matching name or by an unnamed ENDIF or ELSE. An ENDIF or ELSE with a name that 
does not match has no effect. 

Example: 

A demonstration of one use of IF statements in a PPU program: 



lOCATION 

OPERATION 

VARIABIE COMMENTS 

1 


1) 

18 ho 







IF 

DEF,LOOP 



IFLT 

•-LOOP,400 



ZJN 

LOOP 



ELSE 

2 



NJN 

*♦3 



LJM 

LOOP 







• 




• 



This code assembles a zero jump to the symbol LOOP if LOOP has been defined within 37g words (the 
range of a short jump) prior to the occurrence of this code. Otherwise, the NJN and LJM are assembled. 


4-68 


60360900B 










4.9.5 irPL AND IFMI -TEST SIGN OF EXPRESSION 


The IFPL and IFMI pseudo instructions test the sign of an expression and assemble instructions in 
the IF range according to whether the sign of the value is plus (PL) or minus (MI). The pseudo 
instructions allow positive zero to be distinguished from negative zero. 

Format: 


IOCaTION 

OPERATION 

VARIAIIE SUBfieiDS 

ifname 

IFPL 

exp,fnct 

ifname 

IFMI 

exp,fnct 


ifname Optional 1-8 character name 


t, p An expression. It can include only previously defined symbols and the result 

can be absolute, relocatable, or external. If an undefined symbol is used, the 
instruction is flagged as erroneous and assembly continues with the next 
instruction. 

jfnct Optional absolute expression specifying an integer count of the number of 

statements to be skipped. When base is M, COMPASS assumes that fnct is 
decimal. When fnct is blank, the comma can be omitted. 

The ifname and fnct parameters are related as follows: 

1. If a count is supplied, it takes precedence over any ENDIF but not over an ELSE. TTie only 
effect of an ENDIF in a count controlled sequence is to be included in the count. Skipping 
terminates when the count is exhausted or when an ELSE with a matching or blank name is 
encountered, whichever occurs first. 

2, If neither a count nor a name is supplied, the IF range is terminated by the first ENDIF or 
ELSE encountered, whether named or unnamed, 

,*?. If a name but no count is supplied, the IF range is terminated by an ENDIF or ELSE with a 
matching name or by an unnamed ENDIF or ELSE. An ENDIF or ELSE with a name that does 
not match has no effect. 

The condition tested for by IFPL is satisfied if the value of exp is greater than or equal to plus zero; 
the condition for IFMI is satisfied if the value of exp is less than or equal to minus zero. 
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Example: 


The following ppdef defines the CPU instruction MXi jk so that the address value is 60 if (he expression 
value is negative zero or a positive non-zero multiple of 60, otherwise it is the address expression 
value modulo 60. 


1 

LOCATION 

OPERATION 

VARIABLE COMMENTS 

D 


n 

18 Uo 






MXQ 

OPOEF 

REG,VAL ! 



LOCAL 

A 1 


A 

SET 

VAL 1 


A 

SET 

A-A/600*600* 



IFPL 

A,3 1 



IFECi 

0» 3 1 



IFLE 

VALyOyl 



SKIP 

1 1 


A 

SET 

44-660 , 



VFO 

6/<*3B»3/REG,6/A 



EMOM 

1 

1 

1 


Example of call: 


Code Generated 


7777713 

7777713 


i*3*sin 


10 



lOCATION 

OPHATION 

VA«IA8lt COMMENTS 

1 


tt 

16 Uo 








-•5? i 


t*onooni 


SPT 1 


t-4.0 00001 


74.0Do'o01-t-4000001/600*60n 



TFol 

74.000001,3 1 



TFFO 

7 4.000001,0,3] 



TPLf 




‘^KTP 

1 1 


7-4000001 


3PT 74.0 0 0|0 0l76 0r) 



vc-n 

p./a 3B,3 76,6/7 4.000001 



cmhm 

1 

1 


4.9.6 IF - TEST SYMBOL OR EXPRESSION AHRIBUTE 


The IF pseudo instruction tests a symbol or an expression for a specific attribute and assembles 
instructions in the IF range if the test is satisfied. 
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Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 

ifname 

IF 

att, exp, jfnct 

ifnane 

Optional 1-8 character name 


att 

Specifies attribute test. A minus prefix to the attribute causes assembly on 
the false rather than the true condition. 


att 

Condition causing assembly 


SET 

The symbol given la the second subfield was defined by a SE , 
MAX, MlN, or MICCNT 


-SET 

The symbol given in the second subfield was defined other th m 
by a SET, MAX, MIN, or MICCNT 


ABS 

The expression in the second subfield reduces to a value that is 
not relocatable or external 


-ABS 

The expression in the second subfield reduces to either a 
relocatable or an external address 


REL 

The expression in the second subfield reduces to a local or 
common relocatable address 


-REL 

The expression in the second subfield does not reduce to a local 
or common relocatable address 


REG 

The expression in the second subfield contains one or more 
register names 


-REG 

The excreesicn in the second subfield does not contain a register 
name 


COM 

The expression in the second subfield reduces to a common re¬ 
locatable address (any blank or labeled common block) 


-COM 

The expression in the second subfield is not a common relocatable 
address (any blank or labeled common block) 


EXT 

The expr-'^'^sion in the second subfield contains one or more 
external syrr-bols 


-EXT 

The expression in the second subfield does not contain an 
external symbol 


LCM 

The expression reduces to an LCM address 


-I.CM 

The expression does not reduce to an LCM address 


LOC 

The expression reduces to a program relocatable address 


-LOC 

The expression does not reduce to a program relocatable address 
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exp 


jfnct 


DEF 


-DEF 


MIC 

-MIC 

SST 

-SST 


All the swiboLy in the expression in the second subfield are 
defined 

One or more of the symbols in the expression in the second 
subfield is undefined 

The name in the second subfield is a micro 
The second subfield does not contain a micro name 
The second subfield does not contain a system symbol 
The second subfield contains a system symbol 


For SET, SST, -SET, and -SST, exp must be a single defined symbol. For 
MIC and -MIC, exp must be a name. For any other test, it is an expression. 
The expression can include symbols as yet undefined if att is DEF, -DEF, REG, 
-REG, EXT, or -EXT only. If an undefined symbol is used with any other 
attribute, the expression value is set to zero, the instruction is flagged as 
erroneous, and assembly continues with the next instruction. 


Optional absolute evaluatable expression specifying an integer count of the 
number of statements to be skipped. When base is M, COMPASS assumes 
that fnct is decimal. When fnct is blank, the comma can be omitted. 


The ifname and fnct parameters are related as follows: 

1. If a count is supplied, it takes precedence over any ENDIF but not over an ELSE. The only 
effect of an ENDIF in a count controlled sequence is to be included in the count. Skipping 
terminates when the count is exhausted or when an ELSE with a matching or blank name is en¬ 
countered, whichever occurs first. 

2. If neither a count nor a name is supplied, the IF range is terminated by the first ENDIF or 
ELSE encountered, whether named or unnamed. 

3. If a name but no count is supplied, the IF range is terminated by an ENDIF or ELSE with a 
matching name or by an unnamed ENDIF or ELSE, An ENDIF or ELSE with a name that does 
not match has no effect. 


Examples 



LOCATION 

OPERATION 

variable comments 

! 


11 

18 |30 


«BLE 

BSS 

20 j 


• 

• 

• 1 


• 

• 

• 1 


• 

• 

• 1 


TEST 

IF 

REL,ABLE+15 


• 

• 

• 1 


« 

• 

• 1 


• 

• 

• 


TEST 

ENOIF 

IF 

• 

• 

• 

USE 

1 

C0M,DTA,2 ERRONEOUS, OTA AS YET UNDEFINEC 

. 1 

. 1 

• 1 

'' 1 


OTA 

BSS 

! 
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i.^.7 FC - COMPARE CHARACTER STRINGS 


The IFC pseudo Instruction ct mpares two character strings according to the operator specified 
and assembles instructions in the IF range if the comparison is satisfied. 


Forma t- 


I iOC, ’’■ON 

lifnaiTie 



OPERATION 

VARIABLE SUBFIELDS 


IFC 

op, ds tring j ds tring 2 d, fnct 


ilname Optional 1-8 character name 

DeU'iiiiiing rha.rdeter. Characters between the first and second occurrence of b 
character constitute the first character string; characters between the second and 
third occurrence constitute the second character string. 

op ^ecifies comparative test: 


op 

Condition causing assembly 

EQ or -NE 

stringj^ has the same value as stringy 

NE or -EQ 

stringy does not equal stringg 

GT or-LE 

string is greater than string 

GE or- LT 

Stringy is greater than or equal to stringy 

LT or -GE 

stringy is less than string 2 

LE or -CT 

string-, fo less than or equal to string 2 


string. Character string. When IFC is within a macro definition, each character string 

can be a formal parameter. 

?rct Optional absolute evaluatable expression specifying an integer count of the numbe 

of statements to be skipped. When base is M, COMPASS assumes that inct is 
decimal. When fnct is blank, the comma can be omitted. 


Tir ind fnct parameters are related as follows: 

1. If a count is supplied, it takes precedence over any ENDIF but not over an ELSE. The only 
effect of an ENDIF in a count controlled sequence is to be included in the count. Skipping 
terminates when the count is exhausted or when an ELSE with a matching or blank name is 
encountered, whichever occurs first. 

2. If neither a count nor a name is supplied, the IF range is terminated by the first ENDIF or 
ELSE encountered, whether named or unnamed. 

3. If a name but no count is supplied, the IF range is terminated by an ENDIF or ELSE with a 
matching name or by an unnamed ENDIF or ELSE. An ENDIF or ELSE with a name that does 

cot match haw no effect 
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Each character in stringj^ is compared with the corresponding character in string 2 progressing from 
left to right until an inequality is found or both strings are exhausted. When one string is shorter than 
the other, it is padded with a character that has a value less than any other character in the string. 

The truth condition is based on the relative magnitudes of the characters in the strings. 

Examples; 



lOCATION 

OPEIATION 

VAftlABie 

COMMENTS 

1 


11 

18 

30 


TFSTl 

IFC 

EC1,SABC$ABCI 

ABC EQUALS ABC 


TEST? 

IFC 

LT,*AB*ABC* 

AB IS L^SS THAN ABC 


TEST3 

IFC 

GT»XAXX 

A IS GREATER THAN NULL 



IFC 

-GE,*Z*e*,3 

Z IS LESS THAN 6 


The IFC in the following example checks for an empty parameter string. 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


n 

18 

1 30 






XX 

p 

MACRO 

IFC 

FRR 

• 

• 

« 

ENHM 

P1,P2 

FQ,**P2*,l 

1 

' FLAG ERROR 

1 

1 

1 

1 


The following example illustrates an invalidly terminated character string. The asterisk was omitted 
following PI causing an error flag when the comma is interpreted. 



LOCATION 

operation 

VARIABLE COMMENTS 

1 


n 

18 1 30 



IFC 

En,*on*Pi,2$P2 
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19.8 S <IP - UNCONDITIONALLY SKIP CODE 


The SKIP instruction causes C OMPASS to unconditionally skip the instructions in the SKIP range. 
It resembles an IF for which there is no true condition. 

Format 


tOO^TION 

OPERATION 

VARIABLE SUBFiELOS 

ifnf me 

SKIP 

jBict 


ifname Optional 1-8 character name 

I. OptJorti! abs: lute evaludtable expre-ssion specifying an integer count of the num; 

of statements to be skipped. When base is M, COMPASS assumes that |ni t Is 
decimal. 


The ifname anu fnct parameters are related as follows: 

1. If a count is supplied, it takes precedence over any ENDIF but not over an ELSE. The only 
effect of an ENDIF in a count controlled sequence is to be included in the count. Skipping 
terminates when the count is exhausted or when an ELSE with a matching or blank name is 
encountered, whichever occurs first. 

2. If neither a count nor a name is supplied, the IF range is terminated by the first ENDIF or 
ELSE encountered, whether named or unnamed. 

3. If a name but no count is supplied, the IF range is terminated by an ENDIF or ELSE with a 
matching name or by an unnamed ENDIF or ELSE. An ENDIF or ELSE with a name that does 
nci match has no effect- 

The ERR and ERRxx pseudo instructions described in this section either conditionally or unconditionally 

set an error flag. 

4.10.1 ERR - UNCONDITIONALLY SET ERROR FLAG 

A;. EER pseudo instraction produces an assembly error does not affect other code. Usually, it is 
U r 3 d -n conjunctioa with a conditional assembly pseudo .nstruction to force an error into the assembly 
based on an asnemblj' time test. One application is to use a test and ERR to detect illegal macro 
parameters. 
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Format: 


LOCATION 

OPERATION 

variable SU8FIELDS 

flag 

ERR 



flag A single alphanumeric character denoting the error type. The flag is placed 

in the listing to the left of the line for ERR. The flag can denote a fatal or 
nonfatal error. A fatal error causes COMPASS to suppress generaticai of the 
binary deck unless the D mode option is selected on the COMPASS control 
card. If no flag is specified, or the character is not one of those given in 
section 11.7, COMPASS uses P. 

A variable field entry, if present, is ignored. 



4.10.2 ERRxx - CONDITIONALLY SET ERROR FLAG 

An ERRxx pseudo instruction produces an assembly error when a condition detected during the second 
pass of the assembler is true. 

Format: 


LOCATION 

OPERATION 

variable SUBFIEIOS 

flag 

ERRxx 

aexp 


flag A single alphanumeric character denoting the error type. The flag is placed 

in the listing to the left of the line for ERR, The flag can denote a fatal or 
nonfatal error. A fatal error causes COMPASS to suppress generation of the 
binary deck unless the D mode option is selected on the COMPASS control card. 
If no flag is specified, or the character is not one of those given in section 11.7, 
COMPASS uses P. 
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XX 


Defines condition under which aexp value is erroneous. 


aex j 


XX 

NG or MI 

NZ 

PI. 

ZR 


Error Condition 
Value of expression is negative 
Value of expression is nonzero 
Value of expression is positive 
Value of expression is zero 


Absolute expression. It cannot contain external symbols or references to blanl; 
common. The test is made in pass two of the assembler. Relocatable addresses 
are assigned values relative to program origin rather than to the block in vhich 
they are defined. 


NOTE 

ERRxx i£ the only conditional instruction for which the 
test is made in pass two. Therefore, this is the only 
pseudo instruction that can be used to determine Pl’U 
overflow if the PPU program has literals and USE 
blocks. 


P'tample; 

Test for memory overflow in PPU assembly 


Location Code Generated 


LOCATION 

O^IATION 

VAIIAHE COMMENTS 

1 

7*»%f 1 

7777447 

715? 

1 



18 130 

i 

[ i 

' 

' j 

! 

LASTTAG 

P i 

i 

PERIPH 

• 

• 

:rss 

fc'RRPL 

r :-?n I 

-1- 

1 

1 

0 

LA5TTAG-7777| 


4.11 LISTING CONTROL 

li!.- ijiStrucUons described in this .-section permit exUnsive ccntrol of the assembly listing format. 


4 11.1 LIST - SELECT LIST OPTIONS 

: . L ‘ST pseudo Instruction controls the content and format of the assembler listing. LIST instruction 
It-,, disabled under either of the following conditions: 

When the list parameter (L) on the COMPASS control card (section 10.1. 2) is zero, or 
When the list option parameter (LO) is used on the COMPASS control card. 
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IJ.se of the IJSl’ pseudo instruction is optional. If it is not used in the subprogram, COMPASS list 
output is according to the L and LO parameters on the COMPASS control card. If the LO parameter 
is omitted or LO O, the list options are as if L, B, N, and R only are selected and the listing ccaitains 
heading information, assembly text, assembler statistics, an error directory (upon occurrence of an 
error only), and a symbolic reference table. Formats of this output are described in detail in 
chapter 11 and brief summaries are given below. 


Heading information Program length, origin, and length of each block, entry points 

and external symbols. 


Assembly text 


Assembler statistics 


Error directory 
Symbolic reference table 


Line, and assembly results of each line assembled (not skipped) 
from the input device (excludes code generated by RMT, DUP, 
ECHO, XTEXT, or a macro or opdef expansion). For data 
generating pseudo instructions DATA, DIS, BSSZ that produce 
more than one word of object code, only the first word is listed. 
For VFD and CON all words of object code are listed. For R=, 
only the pseudo instruction is listed. 

Each occurrence of the LIST instruction is listed. 

Amount of storage used, counts of assembled statements, 
defined symbols, invented symbols, and references to symbols. 

Lists fatal and nonfatal errors and summarizes the causes of each. 

List of all symbols defined in the program according to symbol 
qualifier, if any, followed by an index to every reference to the 
symbol in the listed statements. 


Formats; 


LOCATION 

OPERATION 

VARIASIE SUSfIflOS 


LIST 

oPj,op2,... ,op^ 


or 



LIST 

* 


A location field symbol, if present, is ignored. 

“Pi A list option represented by a single letter or a letter prefixed 

by a minus sign. The unprefixed letter selects the option; the 
prefixed letter cancels the option. Options are separated by 
commas and terminated by a blank. 

A List statements actually assembled 

Wdien A is not selected, a line containing concatenation 
and micro substitution marks is listed with the marks in it 
exactly as presented to the assembler. When the A option 
is selected, however, the assembler lists the line before and 
after the editing takes place. Selecting A also causes the 
listing of lines of code resulting from the R= pseudo instruction. 
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B List binary control statements 

Wien B is selected, the listing includes SEG, SEGMENT, IDENT, and 
EIJD pseudo instructions. 

C List listing control statements 

When C is selected, the listing includes EJECT, SPACE, TTL, and 
liTLE pseudo instructions. A listing instruction that causes an EJECT 
is listed as the first line of the new page after the EJECT takes place 

D Include details 

Selection of the D option causes listing of the following items not normally 

listed: 

Second and subsequent lines of DATA and DIS 

Code assembled remotely when HERE or END causes its assembby 
Literals block 
Default symbols 

E Include echoed lines 

Selection of E causes listing of all iterations of code duplicated as a resuU 
of DUP and ECHO. 

F List IF-skipped lines 

Wlien F is selected, the listing includes all lines skipped by IF, IFop, 

IFC, IFPP, IFCP, SKIP, and EI.SE. In addition, the Symbolic Reference 
Table contains references to symbols in IF statements. 

G List generated code 

Selection of this option causes listing of all code generating lines regardless 
of list controls other than L. Instructions listed include symbolic machine 
instructions and BSS, BSSZ, CON, DATA, DIS, R=, and VFD. 

L Master list control 

This op^’o" is noirnajlv selected. VOierj L is canceled, the long list contain* 
error flagged lines, an error directory, and LIST pseudo instructions only, 
regardless of selection of any other options on LIST. 

M List macros and opdefs 

Selection of M causes all lines generated by calls to macros and opdefs other 
than those defined by the system to be listed. 
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N List nonreferenccd symbols 

This option is normally selected. Cancellation of this option causes 
any non-system symbol for which no reference has been accumulated 
(e. g., all occurrences are in IF statements with the F option deselected, 
or are between CTEXT or ENDX with the X option deselected) to be 
omitted from the symbolic reference table. 

R Accumulate and List references 

This option is normally selected. When R is canceled, COMPASS does 
not accumulate references. R should not be canceled if a complete 
symbolic reference table is desired. If R is canceled at the end of 
assembly, no symbolic reference table is produced. 

S List systems macros and opdefs 

Selection of S causes all lines generated by calls to systems-defined 
macros and opdefs to be listed. 

T List nonreferenced system symbols 

Selection of this option causes a symbol defined through SST to be 
included in the symbolic reference table even if there are no accumulated 
references. 

X List XTEXT lines 

Selection of the X option causes listing of all statements assembled as a 
result of an XTEXT pseudo instruction. CTEXT and ENDX provide a 
means of alternately turning this external designator off and on. 

$ A dollar sign in the variable field selects all options. 

* An asterisk in the variable field causes selection of the options in effect prior 

to the current selection. The assembler records occurrences of LIST pseudo 
instructions and maintains a table of the most recent 50 occurrences. Each 
LIST * resumes use of the most recent entry and removes it from the list. 
When the subprogram contains more LIST * instructions than there are entries 
in the stack, COMPASS selects the default list options (B, L, N, and R). 


For list options A, C, D, E, F, M, S, and X, all applicable options must be selected for a specific 
line to be listed. For example, listing of an expansion resulting from a DUP within a macro requires 
selection of both M and E. Similarly, an expansion causes by an XTEXT within a system macro call 
is listed only when both X and S are selected. To obtain a listing showing pand 4 marks removed from 
external text inside a DUP range requires that A, X, and E all be selected. 


Example: 


Q 17205146314631463146 

2 17205146314631463146 

3 16403146314631463146 

4 17205146314631463146 

6 17205146314631463146 

7 16403146314631463146 



LOCATION 

— 

OPERATION 

VARIABLE COMMENTS 

I 


n 

18 Uo 







LIST 

A ' 



DATA 

1.3.*EE 1 



OATA 

1.3EE ' 



LIST 

D 1 

! 


UAI A 

1.3^Et 1 

I 


OATA 

1.3EE ! 

i 


LIST 

-A,-0 



UAl A 

1.3i«EE 1 



LIST 

♦ 



DATA 

1.3r*EEj:# 



OATA 

1.3EE 
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4.11.2 EJECT— EJECT PAGE AND BEGIN NEW SUB-TITLE 

The EJECT pseudo instruct on advances printer paper to a new page before printing. Then, page 
headings are printed and lifctlng continues. EJECT has no effect, other than setting the sub-subtitle, 
if it is generated by DUP, ECHO, RMT, XTEXT, or a macro or opdef expansion, and the cor- 
resjxjnling LIST options are not all selected. 

jf'onna!: 


LC-. ATION 

CPERATION 

VAKIABLE SUBFIELOS 

name 

EJECT 



New program sub-subtitle for the page will be printed in character positions 

70-79 of tli>; cccond line of the page. A blanic name clears the sub-subtitle. 

An entry in the variable field, if present, is ignored. 


4.11.3 SPACE-SKIP LINES AND BEGIN NEW SUB-TITLE 

'Die SPACE pseudo instruction spaces the assembler listing. When a page is full, an eject occurs 
and listing resumes on the next page. A SPACE Immediately following an EJECT is ignored. SPACf 
has no effect, other than setting the sub-subtitle, if it is generated by a DUP, ECHO, RMT, 
XTEJIT, or a macro or opdef expansion, and the corresponding LIST options are not all selected. 


LOCATION 

OfEIATION 

VAKIAtlE SUIEIEIOS 

name 

SPACE 

sent, rent 


aarne New subprogram sub-subtitle will be printed in characters 70-79 on the second 

line of the next page heading. A blank name clears the sub-subtitle. 

sent An absolute expression specifying a positive Integer number of spaces between 

the most recent line and the next line of printout. If base is M, sent is assumed 
to be decimal. If sent is omitted or zero, no line is skipped. 

An absolute expression specifying a positive integer number of lines that must 
be remaining on the page foliowiug spacing. If base is M, rent Is assumed to 
be decimal. 

If sent + rent exceeds the number of lines on the page before spacing occurs, the SPACE acts like an 
EJECT. Note that either the eject occurs or the number of spaces are skipped but not both. 

Blank cards can also be used to space the listii^. 
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4.11.4 TITLE - ASSEMBLY LISTING TITLE 


The first TITLE pseudo instruction establishes the title that will be printed on each page of the listing. 

A subsequent TITLE instruction generates a subtitle and causes a page eject. If the subprogram does not 
include a TITLE instruction, COMPASS prints the variable field of the first IDENT pseudo instruction 
as the title. A TITLE instruction without a character string produces an untitled listing. A nam*. in 
the location field introduces a new subprogram sub-subtitle. 

A TITLE Instruction has no effect when LIST option X is deselected and the TITLE Instruction is 
In text read by XTEXT or is between CTEXT and ENDX Instructions. All other TITLE instructions 
(except the first which sets the main title) cause a page eject, even when generated by a macro 
expansion, unless LIST option L is deselected. 

Format: 


LOCATION 

OPEKATION 

VARIABLE SUBFIELOS 

name 

TITLE 

string 


name New subprogram sub-subtitle to be printed in character positions 70-79 

on the second line of the page. A blank name clears the sub-subtitle. 


string COMPASS searches the columns following the blank that terminates the 

operation field. If it does not find a nonblank character before the default 
comments column (see COL pseudo instruction), it takes the characters 
starting with the default comments column minus one up to the end of the 
statement. Otherwise, the title or subtitle begins with the first nonblank 
character following TITLE and continues to the end of the statement or to 
62 characters. Any characters beyond the 62nd are lost. A blank string 
produces an untitled listing. 

Example: 



LOCATION 

OPERATION 

VARIABLE COMMENTS 



II 

ie Uo 



lOENl 

LIST 

TITLE 

• 

mto I 

C 1 

MT DRIVER 1 

1 



• 

• 

TITLE 

• 

• 

• 

1 

1 

1/0 routines! 

1 
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Fir ft page: 


HT DRIVER 


Subsequent pages: hT DRIVER 

I/O ROUTINES 

4.11.a m-NEW ASSEMBLY USTiNG TITLE 

ibe rXL pseudo instruction Introduces a new main title to be printed on each page of the listing, and 
t ieai B he subtitle. 

Format; 


tor AT ION 

OPERATION 

VARIARLE SUIFIELOS 


TTL 

string 


sti'lng COMPASS searches the columns following the blank that terminates ttie operating 

field. If it does not find a nonblank character before the default comments columi- 
(see COL pseudo instructicm), it takes the characters starting with the default 
comments column minus one up to (he statement end. Otherwise, the title begims 
with the first nonblank character following TTL and continues to the end of the 
statement or to the 62nd character. Any characters beycmd the 62nd are lost. 

A blank string produces an untitled listing. 

name New sub-subtitle to be printed in character positions 70-79 on the second 

line of the pages. A blank name clears the sub-subtitle. 

TTL does not cause a page eject. 


4.11.6 NOREF-OMIT SYMBOL REFERENCES 

Tha HOHEi; pseudo instructioa causes the symbols named in the? variable field to be suppressed from 
the symbolic reference table. 


Format: 


lOCATION 

OPERATION 

VARIAIIE SUSFIEIDS 


NOREF 

i 

symj^ , symg, . -., aym^^ 

1 


sym^ 


One or more symbols defined in the subprogram. If a s 3 rmbol qualifier is in 
effect when the NOREF is encountered, the symbols are assumed to be qualified 
by the qualifier in use. Alternatively, sym can be a non-blank qualifier symbol 
enclosed by slant bars, /qualifier/, in whi^ case all symbols qualified by the 
specified qualifier are suppressed from the siunbolic reference table. 


A location field symbol, if present, is ignored. 


«O36Otf0OC 
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4.11.7 CTEXT AND ENDX - DISABLE/ENABLE LISTING OF COMMON DECK TEXT 


The CTEXT pseudo instruction sets the XTEXT flag for list control. 

NOTE 

When the flag is set, external text is listed only if 
the X list option is selected. 


Format: 


LOCATION 

OPERATION 

VARIABLE SUBFfELDS 

name 

CTEXT 

i 

string 


^^ame If X list option Is selected, name (optional) Is treated as a sub subtitle; 

otherwise It is ignored. 

string If the variable field is nonblank and the X list option is selected, the CTEXT 

is treated as a subtitle. The CTEXT instruction generates a subtitle and 
causes a page eject. If X is not selected, the CTEXT does not affect titling. 

The subtitle begins with the first nonblank character following CTEXT 
or in the default comments column (see COL pseudo instruction) minus 
one, whichever comes first, and continues to the end of the statement 
or to 62 characters. Any characters beyond the 62nd are lost. 


The ENDX pseudo instruction clears the XTEXT flag for list control and causes listing to resume, 
starting with the instruction after ENDX, when the X list option has not been selected. 

Format: 


1 

LOCATION 

OPERATION 

VARIABLE SUBFIEIDS 


ENDX 



Entries in the location field or variable field, if present, are ignored. 
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4.i1.8 XREF—REFERENCE SYMBOLIC ADDRESS 


The XREF pseudo instruction provides the options of having the symbolic reference table contain 
references to symbols according to (1) location counter address, (2) page and line number, or (3) both. 
For the format of the symbolic reference table, refer to secticm 11.8. 

Foniixt' 


ATIOM 

OPEIATION 

VAasABlE SUIFIEIOS 

i 

XREF 

[ ' 

string 


string An optional character string, the first character of which indicates how symbols 

are to be referenced. 

A The symboUc reference table lists addresses only. Flags are not included 

B The symbolic reference table lists references to symbols according to 
page number, line, and address. Flags are included. 

P The symbolic reference table lists references to symbols according to 
page and line numbers. Flags are included. 

A location field symbol, if present, is Ignored. 

If the strin't is omitted or if no XREF is issued, the symbolic reference table contains references 
according to page and line numbers and includes flags. The last XREF encountered in a subprogram 
determines the form of the listing for the entire subprogram. 
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DEFINITION OPERATIONS 


5 


This chapter describes pseudo instructions that involve definition operations. These pseudo 
instructions cause sequences of instructions to be saved for these reasons: 

They can be assembled from an external source PCTEXT). 

Assembly can be delayed until later in the subprogram (RMT). 

They can be assembled repeatedly (DUP and ECHO). 

They can be referred to for assembly (MACRO, MACROE or OPDEF). 

! '■£.! "unions jther tiian END^ i icludifig ot'ner definitions or calls, can be in the body of a definition. 

Each request for assembly of one of the saved sequences of code, such as a reference to a macro, 
causes in enti'y in the assembler recursion stack. The most recent entry in the stack points to the 
source of statements (the definition) to be assembled. WTien the definition contains an inner, nested, 
reference to a saved definition, the stack pointer is changed so that the source of statements is the 
imiermost definition. The stack allov/s nesting of definitions to a maximum level of 400. When the 
e ,d of a definition is reached, the assembler switches to the preceding entry in the stack. When the 
stack is empty, the assembler resumes assembly of the next statement in the input source deck. 

A nested definition must be wholly contained by its next outer definition. 

Definitions are saved compressed but otherwise unedited (with micro and concatenation marks). Editing 
occurs each time the definition is processed. Compression removes blanks and replaces them with 
coded bytes as follows: 

A single space is represented by 55g; it is not compressed. Two or more embedded spaces are 
replaced in the image as follows: 

2 spares replaced by 5555^ 

3 ;,p,>....es replaced by 0002 

4 spaces replaced by 0003 


64 spaces replaced by 0077g 
6.5 spaces replaced by 007755g 

66 space - replaced by C0775555„ 

O 

67 spaces replaced by 00770002 etc. 

8 ’ 

1 railing spaces are considered as embedded and are included in the image. The 00 character 
(colon) is represented by the 12-bit code 0001. A 12-bit zero byte marks the end of the statement. 

The listing identifies the source of statements and the recursion level for all definition operations. 
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For XTEXT, DUP, and IXHO, assembly occurs as soon as a definition is saved. Unless the definition 
contains a USE, USELCM, or ORG instruction, code is assembled into the block in use when the 
XTEXT, DUP, or ECHO is encountered. For RMT, macros, and opdefs, however, definition and 
assembly take place in two steps. The block in use at definition time does not determine where code 
in the definition will be assembled. That is, code is assembled into the block in use when the definition 
is assembled if the definition does not itself contain a USE, USELCM, or ORG. 

Similarly, for XTEXT, DUP, and ECHO, any qualifier in effect when the pseudo instruction is 
encountered applies to symbols defined in the sequence (assuming the sequence does not contain a 
QUAL). For RMT, macros, and opdefs, however, because definition and assembly take place in two 
steps, the qualifier in use at definition time does not affect symbols in the definition. The qualifier, 
if any, in effect when the definition is assembled is applied to the symbols defined in the sequence. 

A qualifier applies to symbols only. It does not apply to block names or to the names of DUP, ECHO, 
RMT, or macro definitions, nor to any substitutable parameter names. 

In definitions having substitutable parameters, it is possible to use a different block name, different 
qualifier, or different symbols with each expansion simply by declaring either the qualifier symbol, 
block name, or symbols to be qualified as substitutable parameters. (For an example, refer to 
example 7 under Macro Call.) 


5.1 EXTERNAL TEXT (XTEXT) 

The XTEXT pseudo instruction provides a means of obtaining source statements from a file other than 
that being used for input. COMPASS transfers the text from the external source and assembles it 
before taking the next statement from the interrupted source of statements. The file may be a sequential 
file, an indexed file with named records, or an UPDATE or MODIFY random-access program library 
file. 

Format: 


LOCATION 

OPERATION 

variable subfielos 

file 

XTEXT 

rname 
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Name of a file containing source statements. If file is omitted, COMPASS 
assumes the file named in the X parameter on the COMPASS control card 
(Sect'on 10.1.2). If no X parameter was specified, COMPASS assumes OLDPL. 

If rname is biank, COMPASS assumes that the file is sequential; it rewinds the 
file and reads the first section. If rname is not blank, it is the name of the 
section to be read. The file must be a SCOPE 3 indexed file with named 
records,! a record indexed file with named records, a random-access program 
library file in UPDATE format, or a random-access program library file in 
MODIFY I format. 

Text records may be in any of the following formats. 

1, Normal text. If the first line contains rname starting in column 1, it is skipped. 

2, A common deck in an UPDATE or MODIFY f I’andom-access program library file. If the file 
is in UPDATE format, the first line <*COMDECK rname) is always skipped. 

3, nu UPDATE or MODIFY j compressed compile file section. 

COMPASS reads source statements to an end-of-section mark or an END pseudo instruction. 


f.le 


rnam e 


S.2 REMOTE ASSEMBIY 

Definit-on ;md assembly of remote code talces place in two steps. A pair of RMT pseudo instructions 
delimit code that is to be saved for later assembly. Later, a HERE pseudo instruction directs 
COMP/iSS to assemble a specific sequence of remote code or to assemble all unlabeled remote code. 
An END instruction causes any unlabeled remote code to be assembled. 


5.2.1 RMT - SAVE REMOTE CODE 

A RMT pseudo instruction signals the beginning or the end of a sequence of code to be assembled 
remotely. 


Format: 


1.0CAT!ON 

operation 

VARIABLE SUBFlElDS 

rmtname 

RMT 



rmtname Optional 1-8 character name identifying the remote sequence. It is 

significant on the beginning RMT only. The field is ignored for a terminating 
RMT. If supplied, rmtname can be used on a subsequent labeled HERE. 

If the sequence is unlabeled, an unlabeled HERE or END causes its assembly. 

A variable field entry, if present, is ignored. 


t MODIFY is not supported by SCOPE 2. 
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Any instruction legal when the remote lines are called for assembly is legal between the RMT pair. 
If expansion of an RMT reveals a second RMT pair implicit to the saved definition, assembly of the 
first pair must occur through a HERE instruction so that the inner pair will be expanded by an END. 
Similarly, if the assembly of the second pair reveals yet a third RMT pair, the second pair must be 
assembled through a HERE rather than the END, etc. 

Any labeled remote code present when END is processed is discarded without notice. 


5.2.2 HERE - ASSEMBLE REMOTE CODE 

A HERE pseudo instruction causes the labeled remote sequence to be assembled or unlabeled saved 
remote sequences to be assembled. In the absence of a USE, USELCM, IDENT, or an ORG within 
the saved sequence, the remote code is assembled under the block in use at the time the HERE is 
encountered. In the absence of a QUAL within the saved sequence, symbols are qualified under the 
qualifier in use at the time the HERE is encountered. RMT code is assembled only once. After it 
is assembled, it is no longer saved. A HERE encountered when there is no remote text saved has no 
effect on assembly. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIDS 

rmtname 

HERE 



rmtname Optional; the name of a previously saved RMT sequence. Only the named 

sequence will be assembled at this time. 

A variable field entry, if present, is ignored. 

If unlabeled remote sequences still remain to be assembled when the END card signaling the end of 
assembly is encountered, COMPASS assembles them before it terminates assembly. However, any 
RMT pairs that might have resulted from the assembly are lost. Also, any remaining labeled remote 
code is lost. 

Examples: 

The following example illustrates use of RMT within a macro definition. Following the last call to 
the macro, a HERE causes all saved unlabeled RMT sequences to be assembled. 
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Locatioi Code Generated 


LOCATION 

OPSIATION 

VARIABLE COMMENTS 


I 


tl 

U |30 




MACRO 

TABLE»TNAH»EQIV 





IFC 

EQ,**EQIV* ' 




rNAH 

EQU 

•-ORIGINS 1 




O.TNAH 

CON 

BUCKET 1 





ELSE 

2 1 




TNAM 

EQJ 

EQIV 1 




O.TNAH 

EQU 

O.EQIV 1 

1 





RHT 

1 




l.tnah 

EQU 

TNAH^SIZES I 





RHT 

• 

1 

1 





• 

ENOM 

• 

[ 

i 


. - .,. . 


INJ E R , . 

• 

table 

1 


fx 



IFCs... 

ia,8*4 1 ' 

TAttA 

f I33i 


XIITC8 

CQU“ 

•-ORIGINS 1 

TAOLE i 

I«3088iiatott8oa323a% 


O.IMTCfl 

CON 

•UCKET 1 

table 




ELSE 

* . 

table 





1 

TABLE 

' 



RNT 

1 

table 



L.ZNTeil 

EQU 

ZNTER4SZZES 

TABLE 



• •- 

RNT 

1 „ 

TAOLE 




ENON 

1 X lAtLA-' 



LASTAB 

TABLE 

1 





IFC 



1332 


LASTA8 

EOiU 

•-ORIGINS 1 : tmjL 

%738 tsoettfitieffttsesoti 


O.tASTAt 

CON 

8UCKET 

tAOLI 




EtSI«* 

2 ! S“ - 

1 ' 5 riSMi 

■„ . ■’ 



RMT 

t 

TABLE ; 



t.LASTAS 

EQU 

LASTAO^StZES 

EABLE .. 




RHT 

1 ■ .i im« . 




ENOH 

- f -«»■ 'iwiNiii 


4731 


nrtab 

table 

LASTAB 1 





XFC 

EQ#**tASfA8* . 





ELSE 

2 f 

TAILE/^ 

1332 


NRTAe 

EQU 

LASTAt I 

TAiMt;| 

4738 


O.MRTAt 

EQU 

« O.LASTAQ 







table"- 




RHT 

1 

TMAE- 



L.NRTA8 

EQU 

NRTA8«8ZZtS 

table: 




[RHT 

f .1 lAQUr 




liNAH 

• 

1 





• 

• 

HERE 

1 

1 





EQU 

IHTtR4tX2tS • ' ' T 


4873 


l.LASTAt 

EQU 

LASTA04SUgl.. 


4873 


W«IIATA8 

EQU 

NRTAQ4ttZES .' - . 1 

•RiirA. 
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In the following example, assembly of the RMT sequence is caused by the END statement. 



5.3 CODE DUPLICATION 

This section describes two pseudo instructions (DUP and ECHO) that cause a sequence of code to be 
assembled repeatedly. For a DUP sequence, each assembly is identical with the first, and the 
number of repetitions is specified or is indefinite. For an ECHO sequence, each assembly resembles 
a macro reference. Actual parameters supplied in a list are substituted for formal parameters on 
each repetition of the code sequence. The nximber of repetitions is determined by the number of 
actual parameters provided on the ECHO instruction. 

Every inner DUP or ECHO sequence must lie totally within the range of the next outer DUP or ECHO, 
or a fatal E error is flagged. 


5.3.1 DUP-SIMPLE DUPLICATION 

The DUP pseudo instruction specifies repeated assembly of the statements immediately following. 
The range of the DUP is specified either by a source statement count on the DUP instruction or by an 
ENDD. 
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format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 

dupname 

DUP 

rep,j?nct 


dupname 


rep 


Jfnct 


Optional name of the DUP sequence; 1-8 characters. When supplied, it can be 
used in an ENDD. When no name is supplied, the range of the DUP is detemiinea 
by a statement count or by any ENDD. 

Absolute evaluatable expression specifying the integer number of times state¬ 
ments in the DUP range are to be assembled. If rep is null or zero, the instruc¬ 
tions in the range are not assembled; that is, code is skipped. When base is M, 
COMPASS assumes that rep is decimal. 


NOTE 

A very large (unobtainable) repeat count in conjunction with a 
STOPDUP instruction can be used for indefinite duplication 
of code. 

An evaluatable expression specifying an integer count of the number of 
statements to be assembled repeatedly. When base mode is M, COMPASS 
assumes that £nct is decimal. The count is decremented for statements only; 
comment lines (identified by * in column one) are not counted. On each 
iteration, the assembler copies the source statements and then assembles 
them. Thus, any recursive statements within the sequence are counted 
before they are expanded. 


ihe dupname and fnct parameters are related. 


1. if a count is supplied, it takes precedence over any ENDD. The only effect of an ENDD is to 
be included in the count. Under count control, a name is irrelevant. 

2. If neither a count nor a name is supplied, the DUP range is terminated only by an unnamed 
ENDD. 

3. If a name but no count is supplied, the DUP range is terminated by an ENDD with ^ “Etching 
name or by an unnamed ENDD. An ENDD with a name that does not match does not effect the 

range. 


5.3.2 ECHO - ECHOED DUPLICATION 

The ECHO instruction specifies repeated assembly of the instructions immediately following. On each 
iteration, the assembler copies the source statements substituting an actual parameter in the list for 
each foimal parameter until the shortest list is exhausted, and then assembles the statements. ECHO 
offers many of the features of macros but does not require separate definition and reference. The 
range of the ECHO instruction is specified either by a source statement count specified on the ECHO 
insmiction, or by ;m ENDD. The statement count, when used, is decremented for instructions only; 
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comment lines, identified by * in column one, are not part of the definition and are not counted. 
Format: 


LOCATION 

OPERATION 

VARIABLE SUBPtELDS 

dupname 

ECHO 

jmct,Pj=(listj^),P2=(list2). Pjj =(listj^) 


dupname Optional name of the ECHO sequence; 1-8 characters. When supplied, 

it can be used in an ENDD. When no name is supplied, the range of the 
ECHO is determined by a statement count or by any ENDD. 

fnct Optional absolute evaluatable expression specifying an integer count of the number 

of source statements to be assembled repeatedly. If base mode is M, the 
count is assumed to be decimal. If fnct is zero or omitted, the comma must 
be present and the ECHO range is defined by an ENDD. 

Any recursive statements, such as macro references, are counted before 
they are expanded. 

If the count exceeds the range of an outer DUP or ECHO sequence, a fatal 
E error is flagged. 

The dupname and fnct parameters are related. 

1. If a count is supplied, it takes precedence over any ENDD. The only effect of an ENDD in a 
count-controlled sequence is for it to be included in the count. Under count control a name 
is irrelevant. 

2. If neither a count nor a name is supplied, the ECHO range is terminated only by an unnamed 
ENDD. 

3. If a name but no count is supplied, the ECHO range is terminated by an ENDD with a matching 
name or by an unnamed ENDD. An ENDD with a name that does not match does not terminate 
the sequence. 


Names of not more than 63 formal substitutable parameters. Each name is 1-8 
characters, the first of which must be alphabetic. A name eannot be END, 
LOCAL, ENDD, IRP, or ENDM. A second or later occurrence of a parameter 
name is ignored. A name that begins with a number is ignored. 

The separator between Pj and (listj) is conventionally an = but can be any of the 
following: 

+ -*/()$=, or . 

COMPASS recognizes a substitutable parameter name within a definition when it 
is between any two of the following: 

: +-*/()$= blank , . / or 

The substitutable parameter name can occur in any field within a definition. 
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Before the ECHO definition is stored, COMPASS replaces each use of a 
substitutable name. Otherwise, it saves the definition unedited, i.e., with, 
micro md concatenation marks. Use of the semicolon is restricted in the 
definition because the assembler, when it expands the definition, interprets it 
as a substitutable parameter flag (77g). 

The character r* flags the occurrence of a name not bounded by any other 
special character and, thus, not otherwise recognized. When it expands the 
definition, COMPASS substitutes an actual parameter value from the list for 
the substitutable parameter and removes the r* so that the adjacent items are 
concatenated. 

Because the assembler replaces the first substitutable parameter with 7701, 
the second with 7702, etc. the programmer can use the display characters 
;A, ;B, etc. directly in place of his substitutable parameter names in the 
definition and achieve the same results as if the assembler had replaced the 
name with the ilag. (Example 8, Section 5.4.3 illustrates a similar application 
of this technique.) 

(lisi ) Actual parameter list in the form a^,a 2 ,- • • • substituted for p. 

on the first assembly of the ECHO sequence, ag is substituted on the second 
assembly, etc. until the shortest list is exhausted. Two consecutive commas 
are interpreted as a null parameter. An explicit zero, if desired, must be 
entered. An actual parameter can contain a set of embedded parameters 
enclosed by parentheses. However, the embedded parentheses must be 
properly paired. The assembler removes the outer pair of parentheses before 
substituting the embedded set in a line. A parenthetical item can contain blanks 
or commas. 

If there are no parameters or any of the lists are null, COMPASS assembles the 
ECHO sequence zero times, effectively skipping it. 


5.3 3 STOPDUP-STOP DUPLICATION 

The STOPDUP instruction allows premature termination of a DUP duplication before the repeat count 
is reached or of an ECHO duplication before the shortest list is exhausted. Assembly is completed to the 
end of the range for the current iteration and then continues with the next source statement. Only the 
innermost duplication is affected. 

A STOPDUP outside of a DUP or ECHO range has no effect on assembly. If a DUP or ECHO is nested, 
STOPDUP terminates only the innermost DUP or ECHO. 

I Us mu'-.- 


LOCATION 

---- 1 

OPERATION 

VARIABLE SU8FIEIDS 


STOPDUP 



An entn/ in the location or variable field is ignored. 
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5.3.4 ENDD - END DUPLICATION SEQUENCE 

'Fhe ENDD pseudo instruction terminates a DUP or ECHO sequence when the statement count is 
unspecified on the DUP or ECHO. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIDS 

dupname 

ENDD 



dupname Name of a DUP or ECHO sequence, or blank. A named DUP or ECHO 

sequence can be terminated by an ENDD specifying the sequence by name, 
or by any unnamed ENDD. An unnamed DUP or ECHO sequence that is not 
controlled by statement count is terminated only by an unnamed ENDD. 

An ENDD does not terminate a sequence controlled by a statement count. 

The ENDD is included in the count but has no other effect. 

An ENDD outside the range of a DUP or ECHO has no effect on assembly. 

Examples: 

In the following examples, the statements that result from expansion are shown faded. They are 
listed only when the E list option is selected. Source statements are shown in bold characters. 

1. This example illustrates use of a simple DUP instruction. 



LOCATION 


OPERATION 


9m tttn fffffiittmim 

tittfamff ffttwm 

fifi 


Location Code Generated 


001005 


VARIABLE 


COMMENTS 
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rhis example illustrates a nested DUP instruction with one of the DUP duplications terminated 
jy a STOPDUP. 


OPEKATION VAIIABLE 


tc 

TAG {micro 

IFC 

STOPOUf 
MO BFT 

GO ENDM 

alphabet micro 

NO SFT 

bup 

{go 

I ENDD 

micho 
TA« MICRO 

IfC 

xrc 

StOROU^ 

NO SET 

ENDM 

i ENOO 

•0 

Imjcro 

TMi I KICRO 

■■■:' ifC 

JEC 

STOROUR 
NO Set 

, - Enon 

V'-ii:::, I ENDO 


PO 

NtCRO 
Nicro 
a EC 
If c 

sroROui! 

BET 

CMOM 

EWSC 


NO.J./HALPHaBET#/ 
EQt/fTAQf/E/,1 


1»*/A8C0EFGhIJK/ 

I 

-1 


NO*l*/#At.RHAtfTR/ 

NOtlf/ASCOCRRMZJK/ 

eo«/fTA9#/e/«i 


assemble stopoup when tag«c 

no is 6 IN LAST ITERATION 


unobtainable iteration COUNT 


A SSEMtUe^ STOROUR when TRSiiC 


CO,/A/E/il ASSEMOte STOROUR WHEN T«S«C 

N04i NO IS S IN LAST ITfRATtOH 


HO»|./#ALRHAtETR/ 
NO*I»/ASCOCrONlUK/ 
EO»VWTaO#/C/, 1 
CQt/B/E/*l AS: 


assemble STOROUR WHEN TABPC 

assemble STOROUR WHEN TAB«E 
NO IS B IN LAST ITERATION 


•tyR«* 

BO 

BO 

BO 

BO 

BO 

BO 

BO . 

•OUR* 

RBUP* 

BO 

BO 

BO 

BO 

BO 

BO 


• ■■■ ;- V'/ 

• ' ■ ■ ■■ ■ ' ^ \ 

• _ _... . ^ 

NO*|*/iALRHASf?R/ ' . SB , . 

N0*1*/aBC0EE0HIJK/ '* . / , B^--/' 

EOt/AT^OW/E/,l assemble STOROUR WHiN ^ BO* 

CO*/E/E/»I ASSEMBLE STOROUR W»«»l TABNI ; 

NO*i NO IS B IN LAST ITfR«ff«^,.^ t.'^ * 
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3. This example illustrates nested ECHO instructions. A statement coimt terminates the second 
level ECHO. The ENDD terminates the first level. Notice how COMPASS assembles each 
copy before it begins the next iteration. 



Location 


LOCATION 


OPEHATION 


VARIABLE 


COMMENTS 


PPOP 

LIST 

ECHO 

ECHO 

LUN 

STM 

ENOD 

LON 

STH 


»ecHo* 

•echo* 

*E«HO* 

♦ECHO* 

•ECi»* 

•ECHO* 

•ECHO* 

•ECHO* 

•ECHO* 

•ECHO* 

•ECHO* 

•ECHO* 

•ECHO* 

•ECHO* 

•ECHO* 

•ECHO* 

•ECHO*. 

*fC»»* 

•ECHO* 

•ECHO* 

•ECHO* 

l*ECHO* 

•ECHO* 

•ECHO* 

•ECHO*, 

♦ECHO* 

•ECHO* 

•ECHO* 

•ECHO* . 

•ECHO* 


LOH X 
StH 

LOH" . X ■:' 
STH 'c . 

ENOO. -- ' i 

ECHO E»n»fA»i»Cli 


i4«« 

l«t7 

1471 

1472 


■'STH A 
LON t 

ST« i 

LON ¥ 

»tH C ■ 

EHOO 

V ECHO 2tPl*U»S*C> 
LON Z 

STH Pi 

LON 2 

^ STH" A 

* LON 2 

rf.- STr. ' • / - -V 

LON 2 . ■ 

-^■-.STH c;.',' . , 

^.‘"EHOOv 

STH TAG I 


1474 

1475 
1477 
IfOO 
lfS2 
litS 


147t 

S41S ISSA 
147» 

541S 0037 
1470 

S41S 0040 


1505 
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5.4 MACROS AND OPDEFS 


A macro or opdef definition is i sequence of source statements that are saved and then assembled 
whenever needed through a macro or opdef call. A macro call consists of the occurrence of the 
macro name in the operation field of a statement. It usually includes parameters to be substituted 
f j " form il parameters in the macro code sequence so that code generated can vary with each assembly 

ot the deiimtion. 

An opdef call differs from a macro call in that the assembler interprets the call by examining the 
formal or syntEiX of the instruction rather than the contents of the operation field alone. The instruction 
comprising the opdef call usually includes parameters to be substituted for parameters in the code 
sequencfc. There are some differences in the way parameters are substituted, however, as is further 

described under Opdef Call. 

I se of a macro or an opdef requires two steps, definition of the macro or opdef sequence, and calling 

if ih£ denniAo:'. 

A definition consists of three parts: heading, body, and terminator. 

Heading A macro definition is headed by a MACRO or MACROE pseudo instruction 

stating the name of the macro and identifying substitutable parameters in 
the body of the macro. 

An opdef definition is headed by an OPDEF pseudo instruction stating the syntax 
of the calling instruction and identifying substitutable parameters in the body of 
the macro. 

The heading optionally includes one or more LOCAL instructions identifying 
symbols local to the definition. 

gody The body begins with the first statement in a definition that is not a LOCAL 

statement or a comment line. A comment line can be either identified by 
in column one or can have columns 1-29 blank. (Following the first statement 
of the macro body, only comments identified by * in column 1 are ignored .) 

Use of the semicolon is restricted because when a definition is expanded a 
semicolon is interpreted as a substitutable parameter mark or a local symbol 
flag. 

The body consists of a series of symbolic instructions. All instructions other 
than END, including other macro and opdef definitions and calls are legal within 
a definition. However, a definition within a definition is not defined until the 
outer definition is called. Therefore, an inner definition cannot be called befcxc 
the outer definition is called. 

A name of a substitutable parameter listed in the heading can occur in any field 
within the body. A reference to a substitutable parameter is recognized when it 
is between two of the following characters in an expression or field: 

. +_*/()$= blank , . ?^ or [— 

The character;—»flags the occurrence of a name not bounded by any other special 
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character, and, thus, not otherwise recognized. On a call, the assembler 
substitutes an actual parameter value for the substitutable parameter and 
removes the p-*’ so that the adjacent items are concatenated. 

NOTE 

The programmer can legally use the characters . ( ); 

$ and = in symbols but when he does, he must be careful 
that these characters are not interpreted as delimiters in 
macro definitions (example 4 under macro calls). 

The macro body optionally contains IRP pseudo instructions that allow iterative 
assembly of a sequence within the body such that each iteration uses a different 
parameter value. 


Terminator 

Definition 

Processing 


An ENDM pseudo instruction terminates a macro or opdef definition. 


A macro or opdef can be defined anywhere in a subprogram before it is called. 
When COMPASS encounters a definition, it places the name of the macro or the 
syntax of the opdef along with the number of substitutable parameters and local 
symbols in the assembler operation code table. Before the definition is saved, 
COMPASS replaces each occurrence of a parameter name or local symbol with 
a 77xx (where xx is a number assigned to the substitutable parameter or local 
symbol). 

On the call, each use of a substitutable parameter (each 77xx) is replaced by 
its actual parameter; each use of a local symbol is replaced by a unique symbol 
generated by the assembler. Usually, symbols replaced in this way have no 
meaning outside the definition. However, if the macro includes an RMT 
sequence which contains local symbols, the local symbols will have meaning 
where the remote code is assembled outside of the definition. 


5.4.1 ENDM-END MACRO DEFINITION 

An ENDM terminates a macro or opdef definition. 
Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIDS 

mname 

ENDM 



mname 


Name of a macro sequence, syntax of an OPDEF sequence, or blank. 
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An ENLM specifying a macro by name terminates the named macro definition and any unterminated 
macro ur opdef definitions within it. An unnamed ENDM terminates all untenninated definitions. 

An ENDM outside the range o ' any macro sequence has no effect other than to be included in statement 
counts. 

Example: 


i LOCATION 

OPERATION 

VARIABLE COMMENTS 

)■ 

n 

18 lao 



- 1 ■ -.■■ ’ 

1 

! JAY 

MACRO 

• 

P1,P2,P3 i 

1 

1 


KAY 

• 

• 

MACROF 

1 

PK2,PK2,PK3;PK«» 

1 

; 

JPX/XQ 

• 

• 

OPDEF 

• 

1 

0P1,0P2,0P3 1 

1 


KAY 

• 

ENDM 

1 

' TERMINATES KAV AND 



• 

• 

1 THf OPDEF DEFINITION 

1 



ENDM 

' TERMINATES JAY 

1 


5.4.2 MACRO - MACRO HEADING 

A MACRO pseudo instruction notifies the assembler to place the instructions forming the body of the 
macro in a table of macro definitions for assembly upon call and place the macro name in the operation 
code table. 

The MACRO pseudo instruction has two forms: 
format one: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 

iTiRanie 

MACRO 

parameters 
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Format two; 


LOCATION 

OPERATION 

VARIABLE SUBFtELDS 


MACRO 

mname, parameters 


The blank location field identifies the second format. 

™''ame A legal name other than END, ENDD, IRP, LOCAL, or ENDM. 1-8 characters. 

A name that is identical to a PPU symbolic machine instruction, pseudo 
instruction, or macro already in the operation code table redefines the 
instruction. The most recent definition applies for the macro call. A 
redefinition causes an informative flag to be issued but the new definition 
holds. 

parameters Names of substitutable parameters. The order in which names are listed 

determines the order in which parameters must occur in the macro call. Each 
name is 1-8 characters, the first of which must be alphabetic. A name cannot 
be END, IRP, LOCAL, ENDD or ENDM. A name that begins with a number, or 
a second or later occurrence of a parameter name in the list is ignored. 

Any of the following special characters separate parameters in the list: 

+ - * / ( ) $ = , or . 

These characters have no meaning other than as separators. A blank 
terminates the list of parameters. Also, any of these characters can be used 
to separate the mname from parameters in format two. 

The total number of unique parameter names and local symbols must not 
exceed 63 for any one macro definition. 

Format one does not require parameters. 

Format two requires at least one substitutable parameter. This parameter is 
termed the location argument because the location field entry in the macro call 
is its substituted value. Omission of the location argument from a MACRO 
instruction in format two causes the assembler to issue a fatal error and 
ignore the definition. 

The assembler ignores a blank parameter produced by two concurrent 
separators or by a separator at the end of the list. 

For an example of definition and calls, refer to Macro Calls. 


60360900B 


Example i of macro instructions: 


1. Legal MACRO instruc ions: 


_ 

lOCATiON 

OPEKATION 

VAIilABLE COMMENTS 

1 

r~— 

IS 

18 ho 


A PC 

MESSAGE 

MACRO 

MACRO 

MACRO 

^ - - — 

P1,P2,P3 1 

OEF*LOC*ONE*THO*TEN 

A ' 


2. MACRO instructions having identical parameter lists. 


n 

ICCATION 

OPeRATtON 

VARIABLE 

COMMENTS 


( 


1 

IB 

l3C 


1 

SUM 

SUM 

SUM 

SUM. 

R«0 

R.IO 

MACRO 

MACRO 

MACRO 

MACRO 

MACRO 

MACRO 

X=Y*7*X 

X(Y+Z> 

X=Y+Z 

X, Y, (Z+XI 

X 

X = X + 1 

jSECOND X parameter IS IGNORED 

1 

'null parameter and second 

jx ARE IGNORED 

IseCONO X AND NUMERIC 
'PARAMETER ARE IGNORED 


3. Illegal use of format two: 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


11 

le 

Uo 



MACRO 

MACRO 

MACRO 

ABC 

ABC, , FP 
ABC,16,FP 

1 NO SUBSTITUTABLE PARAMETER 

1 NULL PARAMETER FIELD 

1 NUMERIC PARAMETER FIELD 
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5.4.3 MACRO CALLS 


A macro headed by a MACRO pseudo instruction can be called by an instruction in the following format: 


LOCATION 

OPERATION 

VARIABLE SU6FIEIDS 

sym 

mname 

Pl.P2.---.Pn 


Optional; depends on definition (see discussion following) 

Pi Parameter list composed of alphanumeric strings. Parameters are separated 

by commas and terminated by a blank. Two consecutive commas constitute 
a null parameter. An explicit zero, if desired, must be entered. 

Each parameter must be in its correct relative position depending on the sequence 
in which its formal substitutable name is given in the MACRO pseudo instruction. 

When the definition MACRO is in format one, the first parameter in the call is substituted wherever the 
first substitutable parameter occurs in the definition, the second parameter in the call is substituted 
wherever the second substitutable parameter occurs in the definition, etc. When the definition MACRO 
is in tomiat two, the location field entry in the call is substituted wherever the first substitutable 
jiarameter occurs in the definition, the first parameter in the variable field of the call is substituted 
wherever the second substitutable parameter occurs in the definition, etc. 

If null parameters are interspersed with legal parameters, the correct positions must be established 
with commas. When the list terminates before the last possible parameter, all remaining parameters 
arc considered null. 

When the first character of a parameter is a left parenthesis, the assembler considers all the 
characters between it and the matching right parenthesis as an embedded parameter or as an iterative 
parameter. It is an iterative parameter when the substitutable parameter has been named in an IRP 
pseudo instruction (Section 5. 4. 9). Otherwise, it is an embedded parameter. 

Ihv assembler removes the outer pair of parentheses before substituting the enclosed character string 
in a line. Embedded parenthetical items must be properly paired, A parenthetical item can contain 
blanks and commas. 

Example: ___ 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

1 


1! 

18 130 



MESSAGE 

(=C»PR0GRAMiABORT.*) 

1 


After substitution, spacing between fields is the same as it was before substitution. One effect is that 
a null actual parameter replacing a formal parameter in a variable field effectively moves the comments 
field to the left. Then, when the line is assembled, the comments could be erroneously interpreted as 
a variable subfield. 


J-18 


60360900A 


Processing of a location symbtl and forcing upper of the first macro instruction depend on the MACRO 
form used for the definition. 


If the macro is defined using format one, that is, die macro name is in the location field, a location 
symbol cn the macro call line forces the first word of generated code upper. The location field symbol 
is assigned the current value of the location counter. A location field (if any) on the line in the 
definition that generates the code is assigned the same address. If the location field of the macro call 
does not contain a symbol, the location and position counters are not affected by the call. 

When the macro is defined using format two, that is, the macro name is in the variable field and the 
first parameter is a location argument, the location symbol of the call is substituted for the first 
parameter or location argument. The fact that this argument came from the location field rather than 
the varir.ble field has no special significance in the macro expansion. In the macro call, the location 
field argument cannot be more than 8 characters. Parentheses are not given the special meaning used 
ii ae Vi field of a macro call Lliie. 

Example: 


1. An illustration of concatenation 


Location Code 

— 

lOCATION 

OfEtATION 

VAIIAIIE COMMENTS 

Generated 

I 


It 

IS |30 


■ -j 


WACRO 

SePl 

• 

• 

FNOM 

• I 

• 

• 

S»2 I 

C kl D ly 

P1»P2 1 

Pl^lReP? \ 

1 

1 

1 

1 

1 

1 

! ■ ss ■ - , { ■ 

% .-- 7 !^ . i- • 


5-i 


60360&00B 


2. An illustration of nested definitions and calls 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

1 


)1 

18 |30 


NAHEl 

• 

MACRO 

• 

-1-—- 

! 


• 

• 

NAME? 

• 

• 

MACRO 

• 

1 

I 

1 

1 


NAME? 

• 

• 

enum 

• 

I 

1 

1 

1 



• 

! 

lAT THIS IIME, This line 



name? 

[IS part of a definition 



• 

• 

{rather than being a call. 

1 


namei 

• 

• 

endm 

« 

1 

1 

1 



• 

NAMEI 

• 

1 

1 

'NAME! is CALLEU ANO EXPANOEU. 

1 

1 



• 

name? 

1 

1 

jcALL TO NAME? IS VALID 




1 


3. The following example illustrates two calls to a definition headed by a MACRO in format two 
using the location argument. The macro is named TABLE; its substitutable arguments are 
TABNAM, VALUEl, and VALUE2, w’here TABNAM is the location argument. 


Ix)catlon Code Generated 


knmmmmHmm 


4743 

IFmttfu 


LOCATION 


MBNAh 


PPVAL 


OfEIATION 


II 


MACRO 

VFO 

ENOH 


TABLE 


VfO 


vahiaile 


COMMENTS 


I 30 


TABLEtTABNAHtVALUEltVALUE? 
60/VALUE1»60/VALUE? 

I 


1 • 01 ? • 0 


I 
I 
I 

call one 




• V ' 

♦ 

♦ 

table 


1.0 




I 
I 
t 

■| 

CALL THO 
( 

I 




Tipai.j 


fRUC' 


20 
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4. kn illustration of embedded parameters: 


Definition; 


n 

LOCATION 

OPERATION 

variable 

COMMENTS 

i.i 


n 

18 

ho 

r 

i 

i 

c. 

K AH 

ill; 

MACRO 

LOM 

LJM 

PNOM 

A,P 

A 

n 

-1-----—---_ 

1 

1 

1 

1 


location 

OPERATION 

variable 

COMMENTS 

T 


11 

18 

ho 

— 


XAM 


{SAH,rND7> 


Expansion: 


Location Code Generated 

r 

LOCATION 

OPEIATION 

VAKIAHE COMMENTS 


n 


1" 

IS ho 

m: 

r 

>11 

4 ’ 'u ‘s 

ImMl 



5, The toUowing example iliuscrates use of R= in macros: 


n 

LOCATION 

OPESATION 

VARIABLE 

COMMENTS 

— 

1 


It 

le 

Iso 


ONSM 

MACRO 

N 

-1---- 

I 



R= 

XI,N 




SX2 

IIB 

1 



RJ 

=XCPM= 

1 



ENDM 


1 


OFFSW 

MACRO 

N 

1 



R= 

XI ,N 

! 



SX2 

12B 

I 



RJ 

=XCPM= 

1 



ENOM 


1 
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6. The following example illustrates a character in a symbol erroneously being interpreted as a 
delimiter for a parameter. 



7. The following example illustrates changing of control blocks and symbol qualifiers through 
substitutable parameters in a macro. (The same call could be used by using micros to 
change actual parameters.) 
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3. rhe following example illustrates a technique that an experienced programmer may wish to 
ise to save time in processing of definitions. Remember that the assembler replaces the 
first substitatable par uneter with 7701, the second with 7702, etc. Note that 7701 is ;A in 
display characters, 7 i 02 is ;B, etc. This means that the programmer can use the display 
characrers directly in place of his substitutable parameter names in the body of the definition 
>nd acjdeve the same results as if the assembler kad made the substitution when it saved ' le 
iefi-iit'-jn. At the tinsf-*. the 'leiitution is assei-ooied, the aEsemhler replaces each 77xx wid mm 
ictual parameter whether tlie code was inserted by the assembler when it saved the definition 
jr by the programmer when he coded the definition. 


n 

lOCATtON 

r~.— 

OPftATlON 



It 


COMMENTS 


jmCRO illStTI,lWTERN«t,CXTERN«L,W:f! 
ICON |?0?C?BTIi 


i 









CHftR 




rtrs 
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5.4.4 MACROE - EQUIVALENCED MACRO HEADER 


A MACROE pseudo instruction can be used instead of a MACRO instruction to notify the assembler to 
place the instructions forming the body of the macro in a table of macro definitions for assembly upon 
call, to place the macro name in the operation code table, and to save the list of parameter names so 
that actual parameters supplied in the macro call can be listed by name in any sequence in the macro 
call. 

The MACROE pseudo instruction has two forms: 

Format one: 


lOCATION 

OPERATION 

VARIABLE SUBPIELOS 

mname 

MACROE 

parameters 


Format two: 


LOCATION 

OPERATION 

VARIABLE SUBflElDS 


MACROE 

mname, parameters 


The blanl^ location field identifies the second format. 
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pr;rrmeterr-; 


A legal name other than END, ENDD, IRP, LOCAL, or ENDM. It can be 
1-8 characters. A name that is identical to a PPU symbolic machine instruction 
name, pseudo instruction, or macro instruction already in the operation code 
table redefines the instruction. The most recent definition is the one that applies 
for the macro call. A redefinition causes an informative flag to be issued hut the 
new definiticn holds. 

Names of substitutable parameters. Unlike MACRO, the order in which names 
are listed does not determine the order in which parameters can occur in the 
macro call. Each name is 1-8 characters, the first of which must be alphabetic. 
A name cannot be END, ENDD, LOCAL, IRP, or ENDM. A name that begins 
with a number, or a second or later occurrence of a parameter name in the list 
is ignored. Any of the following special characters separate parameters in the 
list: 

+ - • ( ) $ = , or . 

These chfM-a-tr'-s have r.-. ester than as s'i'par'itors. A blank termajsi 

the list of parameters. The total number of unique parameter names and local 
symbol" rnu't r.ot exceed 63 for any one macro definition. Also, any of these 
can be usoci separate the mname from parameters in format two. 


Format one dot ? not require parameters. 

tbrmat two requires at least one substitutable parameter. This parameter is 
termed the location argument because the location field entry in the macro call 
is its substituted value. Omission cf the location argument from a MACRO 
instruction in format two causes the assembler to issue a warning flag and 
ignore the definition. 

The assembler ignores a blank parameter produced by two concurrent separat ¬ 
or by a sen.'^rctor at the end of the list. 

For an example of definition and calls, refer to Equivalenced Macro Call. 

5.4.5 EQUIVALENCED MACRO CALI 

A macro definition headed by a MACROE pseudo instruction can be called by an instruction of the 

tbriruit: 


;.OC AT ION 

OPERATION 

VARIABLE SUBfIElDS 

sym 

mname 

Pl-ai,P2=a2... • .Pjj 


Name of MACROE definition 
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Optional symbol. A symbol in the location field causes the location counter 
to be forced upper. The symbol is then assigned the value of the location 
counter. A location field symbol on the first line in the definition that generates 
code is assigned the same address. If the location field of the macro call does 
not contain a symbol, the manner of the force upper is a function of the first- 
code-generating line in the macro expansion. 

An equivalenced parameter. Each p is the name of a substitutable parameter. 
The aj is an actual parameter to be substituted for p-. The parameters need not 
be listed in the same order as they are listed on the MACROE instruction. 
Equivalenced parameters in the list are separated by commas and terminated 
by a blank. 

A null value is substituted for any parameter omitted from the list. 

When the first character of an actual parameter is a left parenthesis, the 
assembler considers all the characters between it and the matching parenthesis 
as an embedded parameter or as an iterative parameter. It is an iterative 
parameter when the substitutable parameter has been named in an IRP pseudo 
instruction (section 5.4.9, IRP). Otherwise, it is an embedded parameter. The 
assembler removes the outer pair of parentheses before substituting the enclosed 
character string in a line. Embedded parenthetical items must be properly 
paired. A parenthetical item can contain blanks and commas. 

After substitution, spacing between fields is the same as it was before substitution. One effect is that 
a null actual parameter replacing a formal parameter in a variable field effectively moves the comments 
field to the left. Then, when the line is assembled, the comments could be erroneously interpreted as 
a variable subfield. 


Processing of a location symbol and forcing upper of the first macro instruction depend on the MACROE 
form used for the definition. 

If the macro is defined using format one, that is, the macro name is in the location field, a location 
symbol on the macro call line forces the first word of generated code upper. The location field symbol 
is assigned the current value of the location counter. A location field (if any) on the line in the 
definition that generates the code is assigned the same address. If the location field of the macro call 
does not contain a symbol, the location and position counters are not affected by the call. 

When the macro is defined using format two, that is, the macro name is in the variable field and the 
first parameter is a location argument, the location symbol of the call is substituted for the first 
parameter or location argument. The fact that this argument came from the location field rather than 
the variable field has no special significance in the macro expansion. 

CAUTION 

After substitution, spacing between fields is the same 
as it was before substitution. 
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IjOcatJou 


Code Generatei 


OPE*ATlON VAdAdE 



I HACROE *,B,C 
'con 'a 
; CCM iB 

i CON j C 
ENOM I 


soar 

#f«f tiNtstmsttiiitimr - 

fti* »9fl«»998S9e0iti0fftil 

.fits r$@itft«8|888i(98t8Si9 


5 4,6 Ol’DEf - DEFINE CPU OPPRAI iON 


CAM A=1,C=S,B=0 

' t , 

CtM* 1 I 

ew § 





An OPDI F ?isei>do iDsm'ct’oi’ rior fi"- the a=,seTT>bler to rjlaoe instruetione is the body of the defioitfoD 
(r» R taj>lf of definitions for asseiro'y upon call and place the instruction syntax in the operation code 
table. There is no way of removing the definition from the table. It can, however, be bt^jassed 
Though 1 edefinition, or disabled through CPSyw, If the syritax duplicates a CPU instruction alrsatly 
o t;ie iKtie, the OPDUF deiinirion tpki s precedence. 


I syistax 


OPEKATION 


OPDEF 


IvARIASU <U(FlflDS 

IparcOiieU,’ rs 


syntax 


The sjTitax consists of a mnemonic operator and variable field descriptors, 
i'he ranem.on.c coerator consists of two letters. Tije first can be any letter 
The second letter can be a register designator: A, B, or X in which ease the 
operation field of the opdef call is recognized as cAn, cXa, or cBn (c is a 
unique character; n is O-T); or the second letter can be any other letter, in 
which case the operation field of theopdef call is recognized simply by a 
two"letter mriemonic, such as EQ. 


The varia'ilc f:ei.d ctet. d-f.ne th»' order of apjpjearance of all. rngiistarr, 

expre3S.to.r;.r, aii.i subfieU] scparctori rbrt o.rmprire tlie variable field of the 
opdef call- It consists of none, one, two, or three of the following 22 subfieid 
descriptors, Q represents an expiressicn. An r represents a register letter 
(A, B, or X). A comma separates two descriptors; a blank terminates the 
synbtx. 
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parameters 


void 

Q 

r 

rQ 

-r 

-rQ 

^1^^2 

ri +r2Q 


-rj+r^Q 

r *r 

1 2 


—r *r 

1 2 

-ri^rgQ 


rj /r2Q 


-rj/r2Q 



-r -r 

1 2 



For example, would be written as -X*B to describe -X3*B1 whereas rQ 

would be written as BQ to describe B2+ALPHA. 

The first descriptor immediately follows the mnemonic operator. 

A substitutable parameter for each register designator (r) and expression 
designator (Q) in the syntax in the order in which they occur in the sjmtax 
(and, consequently, in the calling instruction). Parameters can b.e separated 
by any of the characters: 

+-*/()$=, or . 

A blank terminates the list. 

The assembler ignores a blank parameter produced by two concurrent separators 
or by a separator at the end of the list. A second or later occurrence of a 
parameter name in the list is ignored. 


5-28 


60360900A 


L, sample f; 

i. listed below are some instructions that could be defined through OPDEF and the syntax entries 
that would describe them; 


c 

ailing Instruction j Ctodef 

Operation 

Variable Subfields 

Syntax 

.. 

jpt 

Ktt 

JPQ 

JPt 

Bn+K 

JPBQ 

JP 

Bnj^Bnj^K 

JPB+BQ 

JP 

Bn,K 

JPB,Q 

JP 

Xn/.Xn+K 

JPX/XQ 

; vE‘>' 

Br. Sn, K 

KKB, "ib? 

LJ 

Bn-Bn,An-Xn,K 

LJB-B,A-X,Q 

BXnt 

Xn*Xn 

BX-X*X 

SBnt 

Xn+Bn 

SBX+B 

I.Xn+ 

Bn,Xn 

IXB, X 

JPt 

Bj+K 

JPBQ 

a’-E*' 

Bj, Bk, K 

IvEL.B.Q 

BXit 

-Xk*Xj 

BX-X*X 

SBit 

Xj-Bk 

SBX+B 

SBit 

Bj+Xk 

SBB+X 


*■ Legal COMPASS CPU instructions 
K represents an expression. 
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2. The following complete definition redefines single-address long jump JP as the EQ jump, which 
is faster than JP on the 6600 Computer System. 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

I 


n 

)8 

|30 


JPQ 

OPDEF 

PI 

— 1 ■ - = 

1 



EQ 

PI 

1 



ENOM 


1 


Each subsequent JP instruction that matches the syntax JPQ is assembled as an EQ. A JP 
instruction having a different syntax, such as the following, is not affected. 


Location 

Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 



I 


n 

18 

Uo 

10002 

023000775^ ♦ 



JP 

D3+ALPW« I 


3. The following definition traps all floating point double-precision subtraction instructions 

(DXi Xj-Xk) and jumps to an error-check routine for debugging. I, J, and K are substitutable 
parameters used within the definition. 



LOCATION 

OPERATION 

variable 

COMMENTS 

? 


n 

18 

Iso 


oxx-x 

OPDEF 

J,K 

-1- 



• 


1 



• 


1 



• 


1 



PJ 

CKnUT 

1 



ENDM 


1 


4. The following sequence causes RXi K to be defined as AXi K. It does not affect the standard 
RXi instructions involving registers. 



LOCATION 

OPERATION 

variable 

COMMENTS 

I 


II 

18 

1 30 


RXQ 

OPDEF 
AX.PI 
ENDM 

P1,P2 

P2 

-f---- 

1 

1 


I 


5.4.7 OPDEF CALL 

An opdef call resembles a CPU mnemonic machin-* instruction. The mnemonic code, quantity and 
sequence of registers, arithmetic operators, and expressions (excluding operators within the expressions) 
must match the syntax described in the OPDEF for the definition to be called. 
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NOTE 


If tl:3 Q in a descript»r is combined with register letters, 
a plus or minus must precede an expression in the call. 


OPDEF Syntax 

Call 



JPQ 

JP 

K 

Not combined 

JPBQ 

JP 

Bn+K 

Combined 

JPB,Q 

JP 

Bn,K 

Not combined 

JPX/XQ 

JP 

Xn/Xn+K 

Combined 


An OPDKF call can occur any place after the definition is saved. In substituting parameters, the 
D5;semah:r uses only the register values given in the call, it does not substitute the register desigaatcr ? 

rt iocatit n symool on the opdef call line forces the first word of generated code upper. The location fieu; 
symbol is assigned the current value of the current location counter after the force upper. A location 
field on the line in the definition that generates code is assigned the same value. If the location field of 
the opdef cal! does not contain a symbol, the manner of the force upper is a function of the first code- 
generatiug instruction in the expansion. If the call location field and the code-generating instruction 
lie'id both contain symbols they are assigned the same value. 


Inly a line having the correct syntax calls the definition. 

E.vamples: 

The following opdef defines an instruction having the syntax IXX/X. On the call, the assembler 
substitutes 3, 4, and DIV (not X3, X4, and X. DIV) for PI, P2, and P3, respectively. 


Location Code Generated 


lOCATION 


OftlATION 


VAIIAIIE 


COMMENTS 


130 


IXX/’X 


OPQEr 

f»x,l »2 


X.P2 



W.P3 

NX.P? 

NX.P3 

FX.Pl 

UX.Pl 


X.P3 

x.P2»m 

X.P3«B<> 

X.PB/X.P3 

X.P1,B« 

X.PlyBV 














The following OPDEF selectively traps the SXi Xj+Bk instructions. 


Definition: 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

1 


11 

18 lao 


SXX+B 

OPDEF 

• 

• 

• 

ENOM 

1 

1 

1 

1 

1 


Statements that call the definition: 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

P 


n 

18 lao 

St 

SYM 

atements th 

SX3 

• 

• 

« 

SX.NN 

at do not 

X1+B2 1 

1 

1 

1 

X6+B.XXX 1 

call the definition: 


LOCATION 

OPERATION 

VARIABLE COMMENTS 

1 


11 

18 lao 

-1 


SX5 

SX6 

SX. Y 

SY 

X4 INO R DESIGNATOR OR +. 

1 

B3+X4 [registers INTERCHANGED 

1 

B3 jNO X DESIGNATOR OR OPERAND 

X4^R4 |mNEM0NIC CODE NOT SX. 


5.4.8 LOCAL—LOCAL SYMBOLS 

One or more liOCAI. instructions that list symbols local to the definition optionally follows the MACRO, 
MACROK, or OPDEF pseudo instruction. The only lines that can separate the first header statement 
from LOCAL are comment tines. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBfiElDS 


LOCAL 

symbols 


symbols List of local symbols. Each symbol must begin with an alphabetic character. 

Symbols must be separated by and must not include the following characters: 

+-*/()$=. or . 
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A blank terminates the list. The maximum number of local symbols and 
substitutable parameters is 63. COMPASS ignores the use of a substitutable 
parameter name in the local symbol list. 

A location field symbol, if present, is ignored. 

A symbo: in the list is considered local to the macro; that is, it is known only within the macro 
definition. On each expansion of the macro, COMPASS creates a new symbol for each local symbol 
and substitutes it for each occurrence of the local symbol in the definition (other than in comment lines 
identifier by * in column 1). Thus, invented symbols replace LOCAL-named symbols wherever they 
appear in a macro difinition in a manner similar to the way substitutable parameters are replaced. 

A user passes a local symbol to inner macro definitions or inner macro calls when he does not declare 
the symbol local in any of the inner definitions saved or called. That is, a symbol declared local in a 
macro can be referred to in any inner macro that does not also declare it as local (see example 2). 

V mboi not defined as local is accessible from outside the macro definition. An invented symbol is 
qualified if defined while in a QUAL block. It is not listed in the symbolic reference table. Blanks 
are preserved in a line containing a substituted S 5 unbol; COMPASS makes no attempt to change the 
structure of the line. 

On the listing, each invented symbol is shown as fisym, where sym is unique for each local symbol in 
the subprogram. For example, if the symbol A is declared local to the macro, the subprogram can 
define a different symbol A elsewhere. 

Examples: 

1. In the following example, C is local to macro ABC and is passed to inner macro definitions. 

In the definition, each occurrence of formal parameter A is replaced by the parameter mark 
7701; each occurrence of B by the parameter mark 7702, and each occurrence of C by the 
parameter mark 7703. Then, when ABC is called, COMPASS assigns invented symbol 
tWOOOOl to C and replaces each occurrence of 7703 in definitions ABC and XYZ. 



lOCATION 

0««ATI0N 

VARIABLE 

COMMENTS 


I 


11 

18 

Uo 



ABC 

C 

HACRO 

LOCAL 

BSS 

A«B 

C 

lOB 

1 

1 

1 

1 


i 

! 

• 

• 

• 

XYZ 

• 

• 

MACRO 

SAl 

« 

0 

C 

1 

1 

1 

. ioEFINlTION 
|OF XYZ 

DEFINITION 

OF ABC 



FNDM 

ABC 

3y4 

•ss ^ «• 

1 

1 

1 

1 

EXPANSION pm 


m. 

'■Wmi 

] 

1 

1 DEFINITION 
[of XYZ 

1 

. OF ABC WHifk. 
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2. rn the following example, C is local to each level. Note how this example differs from the 
preceding one. 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


n 

18 

|30 


“bco 

MACRO 

AyB 

' ^ 




LOCAL 

c 

1 



c 

• 

BSS 

tOB 

1 



• 

• 


1 

,DEFINITION 


• 

• 



OF BCD 


Y7fl 

MACRO 


1 




LOCAL 

c 

1 




SAl 

C 

JOEFINITION 




• 


' [of YZA 



C 

• 

BSS2 

1 

1 

1 




FNOM 


1 / 



On the call to BCD, the assembler replaces each occurrence of C with the invented symbol, 
tt000002 including the use of the symbol in the LOCAL instruction for macro XYZ. 



Finally, on a call to YZA, tl000002 is defined as local and the assembler replaces each 
tt000002 with another invented symbol. Thus, each reference to C in the source code SAl 
instruction does not result in a reference to the BSS in ttie outer macro. 


LOCATION 


VADIAtlE COMMENTS 



5.4.9 IRP - INDEFINITELY REPEATED PARAMETER 


VADIABLE 


COMMENTS 


An IRP pseudo instruction in a macro definition signals the beginning or end of a sequence of code to be 
assembled repeatedly with one parameter varied with each repetition. 

It has two formats: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIOS 


IRP 

parameter 


IRP 
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The firs ; form introduces the sequence and names the substitutable parameter; the second form 
terminaies the repeated sequence. In either form, a location field symbol, if present, is ignored. 

The parameter name must be listed as a substitutable parameter on the MACRO or MACROE pseudo 
instruction for the definition. 


On the macro call, the indefinitely repeated parameter consists of one or more subparameters enclosed 
by parentheses and separated by commas. The assembler assembles the sequence for each subparameter; 
the number of copies of the sequence depends on the number of subparameters (none at all when the 
actual parameter is null). When the list of subparameters is exhausted, the assembler continues with 
the next line in the definition. If the named substitutable parameter does not occur between the two 
IRP instructions, the assembler repeats the code unchanged for each subparameter provided in the call. 

An IRP outside of the range of a macro has no effect on assembly other than to be included in statement 
counts. 

Examples: 


1. Repeat sequence within macro 



COMMENTS 


VADIABIE 


definition 
OF ZAB 


REPEATED 

SEQUENCE 


19207 





LOCATION 

OPEIATION 

1 


It 


^ZAB 

MACRO 

IRP 

SAl 

SX6 

SA6 

IRP 

ENOM 

• 

• 



IM 
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2. Assign symbol at every lOOg words of zeroed storage: 



LOCATION 

OPEKATION 

VARIABLE 

COMMENTS 

I 


11 

IB 

ho 



USE 

STORAGE 

-1------- 

1 


BUF 

MACRO 

PI 

1 



IRP 

PI 

1 


PI 

BSSZ 

lOOB 

1 



IRP 


1 

1 



ENON 


1 

( 



BUF 

(P*Q»Rf! 

SfT) 


W^' 

M:- 

tsff 




ml j|.; . 

ivssz' ' 

t«»B 

• , 1 r 



R I ' 

issz 

ttRV 

! ' 




BRSZ . 

tiRS 

1 




itst ^ 

iRiB 

1 






f ; , 



4k.:. .t . . . . 






mum f 

I 


•ur 

iS;- 


5.5 SYSTEM MACRO AND OPDEF DEFINITIONS 


Definitions of such general usefulness that they should be available to any program without each 
program defining them can be placed on the system text file as system macros or can be placed on 
a file accessible through an XTEXT pseudo instruction. 


System macros provide for such system functions as reading and writing files and specifying parameters 
for file environment tables, etc. Systems macro definitions are available to COMPASS for each 
assembly. The programmer can use a macro call for a system macro at any time in his programs 
Descriptions of system macros are given in the operating system reference manual. 

Systems definitions can include any legal macro or opdef definition. An expansion of a call for a 
system definition is not normally included on the assembler listing. Use of the S option of the LIST 
pseudo instruction(Section 4.11.1) enables listing of expansions of system definiticais. 
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OPERATION CODE TABLE MANAGEMENT 


6 


The PASS operation code table contains the information that COMPASS requires for interpreting 
legal operation field entries for COMPASS instructions, 

vvlien assembly begins, the operation code table contains these entries. 

Pseudo instnictions (except LOCAL) 

CPU symbolic instructions (Section 8.4) 

CMTI symbolic instructions (Section 8. 5) 

PPU symbolic instructions (Chapter 9) 

'ijsts.Ti macro and 0 {>def definitions 

The MACRO, MACROE, and OPDEF pseudo instructions (Chapter 5) cause entries to be made in this 
table, in addition, the programmer ha.s the capability of creating entries through the following 
instructicns discussed later in this chapter: 

CPU operation 
PPU operotion 

synonymous PPU or pseudo operation or macro 
Synonymous CPU operation or opdef 

If a new entry redefines an instruction already in the table, the obsolete entry is not physically removed 
from the table. Instead, it is saved so that the table can be reconstructed betvveen assemblies, 
COMPASS reconstructs the operation code table using all the original system macros, opdefs, pseudo 
instructicns, and symbolic machinj instructions. No programmer-created entry is preserved fromi 
assembly to assembly. The number of entries in the table is limited to 4123. 

i he only pseudo instruction that logically removes entries from the operation code table are PURGMAC 
and PURGDEF. 

Entries in the operation code table are in two distinct formats permitting a logical division of the 
table. One type of entry permits identification of an instruction by finding a match for the contents of 
the operation field, thus, it provides mnemonic recognition. The other type of entry is looked at only' 
if the search for a mnemonic operator fails to yield a m.afch during a CPU assembly. 

j his type of entry provides for recognition of an instruction according to its syntax. COMPASS 
analyzes the statement to be interpreted, determines the syntax of the operation and variable subfields, 
and again searches the table. 


CPG"’ 

PPOP 

OPSVN 

CPSYN 
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Instructions recognized in the mnemonic search and the information provided to the assembler for 
each instruction are as follows: 


Pseudo instructions 
Pl’U symbolic instructions 
histructions described through PPOP 
Macro instructions 

Instructions described through OPSYN 


The entry contains addresses to routines that perform 
pass one and pass two operations 

The entry describes the format of the instructions to 
be assembled 

The entry describes the format of the instruction to 
be assembled 

The entry directs the assembler to the location of the 
saved definition 

The entry is a copy of the synonymous entry 


I'or a PPU assembly, a failure to find an entiY for a mnemonic operator causes an operation code error, 
for a CPI assembly, however, if the search for the mnemonic operator does not yield a match, 
COMPASS searches the operation code table again for an entry with a matching syntax. Instructions 
recognized in the syntactical search and the information provided to the assembler for each instruction 
are as follows; 


CPU symbolic instructions 
Instructions described through CPOP 
Instructions defined through OPDEF 
Instructions described through CPSYN 


The entry describes the format of the CPU instruction 
to be assembled 

The entry describes the format of the CPU instruction 
to be assembled 

The entry directs the assembler to the location of the 
definition 

The entry is a copy of the synonymous instruction 
The action taken depends on the synonymous entry 


If, following the second search of the operation code table, the statement still has not been identified, 
the assembler takes the following action: 


For a PPU assembly, it generates a 24-bit instruction of which the first 12 bits are zero. 

For a CPU assembly, it generates a 30-bit zero instruction. 

Although OPSYN and CPSYN pseudo instructions provide a means of rendering more than one 
instruction synonymous, only instructions of the same type can become synonymous. The logical 
division of the table between the two types of entries prevents mnemonically identified instructions from 
being made synonymous with syntactically identified instructions. 

When a MACRO, MACROE, PPOP, or OPSYN creates an entry for a mnemonic name that is already 
in the table for a different instruction, the new entry takes precedence over the old entry. Similarly, 
when a OPDEF, CPOP, or CPSYN redescribes a syntax already in the table for a different instruction, 
the new entry takes precedence over the old entry. As a result, the order of precedence for operation 
field recognition is, from highest to lowest: 

1. Programmer-created entries for mnemonically identified instructions 
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2. System macros, pseudo instructions, PPU symbolic machine instructions, and CMP 

instructions other than the IM instruction. ' 

3. Programmer-created entries for syntactically identified instructions ' 

4. CPU symbolic instructions and the CMU IM instruction 
Example: 

The following example illustrates a special case in which a macro name takes precedence over one 
form of a machine instruction, i.e., the’form using SB4 as an operation code. 


location 


OPERATION 


VARIABLE 


COMMENTS 


I , II 18 


30 


«:b4 


HACRO 


P1,P2 


DEFINE MACRO NAMED SB4 


ENOM 


S84 ’ 


Al*ABi.E 


CALL TO MACRO. .NOT CPU INSTRUCTION 


SB3 


Al+ABLE 


MACHINE INSTRUCTION 


SB4 


OPSTM 


NIL 


PURGMACj SP4 


I disables MACRO BUT DOES NOT 
.RESTORE NORMAL USE OF SB4 
AS AN OPERATION CODE. EVEN IF 
IT HERE REDEFINED WITH OPDEF 
I IT MOULD NOT BE RECOGNIZED. 

THE MACRO FORM ALWAYS TAKES 

'precedence. 

I RESTORES NORMAL USE OF SB4 


6.1 MNEMONICALLY IDENTIFIED INSTRUCTIONS 

Mnemonically identified instructions include all pseudo instructions, macro instructions^ and PPU 
symbolic instructions whether system or programmer defined. PPOP, OPSYN, NIL, and PURGMAC 
provide the programmer with a means of creating or removing operation code table entries that are in 
the mnemonically identified format. 


6.1.1 prop - PPU OPERATION CODE 

The PPOP pseudo instruction defines the operation and variable fields of a PPU symbolic machine 
instruction and creates an operation code table entry for the instruction. COMPASS generates an 
octal machine instruction of the defined format whenever the PPU instruction described by the PPOP 
instruction is used. If the operation code table already contains an entry for the name, the new 
definition talms precedence over the old during assembly of the subprogram or until it is redefined. 
No error is flagged. Any illegal parameter in PPOP causes COMPASS to ignore the PPOP and issue 
a 7-type error flag.' 
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Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 

name 

PPOP 

ctl, val, type 


name Mnemonic name, 1-8 characters 

ctl Control of instruction assembly 

ctl Significance 

0 Illegal; if used, COMPASS ignores the PPOP 

1 24-bit instruction with 12-bit address and no indexing 

2 12-bit instruction with signed relative address or absolute address 
(e.g., UJN) 

3 24-bit instruction with 18-bit address (e. g. , LDC) 

4 12-bit instruction with 6-bit address (e.g. ,LDN) 

5 24-bit instruction with 12-bit address and optional indexing 

(e. g., LDM) 

C 12-bit instruction with signed relative address (e. g., SHN) 

7 24-bit instruction with 12-bit address and required second 

field (e. g., lAM) 

val An evaluatable expression specifying the 4-octal digit operation code value; 

usually, only the two leftmost digits are significant. If the assembly base is M, 
the field is assumed to be octal. 


type 


An evaluatable expression specifying an integer value that COMPASS interprets 
as follows: 


6 


7 


other or 
omitted 


Restrict the instruction being defined to the CYBER 70/Models 72, 
73, and 74; COMPASS sets an error flag if the instruction being 
defined is used in a CYBER 70/Model 76 PPU assembly. 

Restrict the instruction being defined to the CYBER 70/Model 76; 
COMPASS sets an error flag if the instruction being defined is 
used in a CYBER 70/Model 72, 73, or 74 PPU assembly. 

The instruction is not restricted to either machine type. 

If the base is M, type is assumed to be octal. If type is omitted, 
the comma preceding it can be omitted also. 
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Example • 


7 3i I 


Code Generated 


0f»0 


1*^ 

uo 


5415 0040 



lOCATIOt^ 

OPERATION 

VARIABLE 

COMMENTS 

1 


?I 

-1 

le 

|30 



PF9IDH 


-1- 

1 



PASS 

0 

I 

1 



• 


1 



• 


1 



• 


1 


Lfl 

SOU 

15 

i 


r 

pnu 

41 

1 


STM 

PROP 

5,5400+LA 

1 



« 


1 



• 


1 



• 






r 

1 


6.1.2 OPSYN - SYNONYMOUS MNEMONIC OPERATION 

The OPSYN pseudo instruction makes a name in the location field of the OPSYN synon 3 'mous with the 
macro, pseudo instruction or PPU mnesmonic name specified in the variable field. The size of the 
operation code table is the only limit to the number of instructions that can be made synonymous. 

Format: 


LOCATION 

OPERATION 

variable suspielos 

namC]^ 

OPSYN 

name2 


The name in the variable subfield must be previously defined as a standard instruction code. After an 
OPSYN, either name produces equivalent results. If the location field specifies a previously defined 
macro or operation code, the new definition takes precedence over the old without notification. Thus, 
a macro defined by a name that is subsequently used in an OPSYN location field is not called when 
the macro name is used in the operation field. The instruction actually called is the instruction 
named in the variable subfield of the OPSYN. On the other hand, the old macro definition is not lost 
md can be restored by purging the new definition with PURGMAC. 


60360900A 


(i-r, 


F^xample: 


1. An operation named CALL is synonymous with RJM. 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

) 


II 

18 lao 


CALL 

OPSYN 

« 

RJM 1 

1 

1 



• 

CALL 

i 

=XSUBR= IPROOUCCS SAME RESULTS 




IaS if it were an RJM 


2. In the following example, a programmer wishes to use a macro named LJM for part of the 
program and use the real LJM for the remainder of the program. 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


II 

18 

lao 


LJM. 

OPSYN 

LJM 

SAVE ORIGINAL DEFINITION AS LJM 



PURGMAC 

• 

LJM 

PURGE ORIGINAL DEFINITION 

1 


LJM 

• 

• 

MACRO 

XX 

1 

1 

1 

1 


LJM 

• 

• 

ENDM 


1 

1 

1 



« 


i 

^ |COOE USING LJM MACRO 


LJM 

OPSYN 

LJM. 

1 

iRESTORES ORIGINAL LJM 



• 


nCODE USING ORIGINAL LJM 



• 
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6.1.3 NL-DO NOTHING PSEUDO INSTRUCTION 


The NIL pseudo instruction re ^embies a no-op; it produces no code and conveys no information to the 
assembler. It is primarily designed for disabling a macro; it cannot be used with CPSYN. The 
following instructions could be used in place of NIL as nil instructions: 

ENDM 

ENDD 

ENItIF 

IRP 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 


NIL 



A location field symbol if present is ignored. 


Example: 



LCtCATION 

OPERATION 

VARIABLE 

COMMENTS 

n 


n 

16 

Uo 






MflCK 

OPSYN 

NIL 

1 --- 

1 



• 


1 



• 


1 


TAG 

HACK 

Af6t6f73 

1 

1 



« 


1 







The assembler interprets each call to MACK as a NIL instruction. TAG is not defined because it 
becomes the location field symbol for NIL when the statement is assembled. 


6.1.4 PURGMAC—PURGE MACROS 

The PURGMAC pseudo instruction provides a means of disabling operation code entries for the named 
instructions for the duration of the current assembly. 


Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELOS 


PURGMAC 

name^^, nameg,..., namej^ 


name. 


Names of mnemonic operation codes for macro definitions, pseudo instructions 
or PPU instructions. 


A location field symbol if present is ignored. 
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6.2 SYNTACTICALLY IDENTIFIED INSTRUCTIONS 


Syntactically identified instructions apply to CPU assemblies only. The CPOP and CPSYN pseudo 
instructions create operation code table entries for instructions that are to be identified through 
recognition of their syntax, rather than through the contents of the operation field only. 


6.2.1 CPOP - CPU OPERATION CODE 

I’he CPOP pseudo instruction describes the syntax of a new CPU symbolic machine instruction and 
creates an operation code table entry for the instruction. An instruction of the defined format is 
generated whenever the CPU instruction described by the CPOP instruction is used. If the operation 
code table already contains an entry for the instruction, the new definition takes precedence over the 
old during assembly of the subprogram. Any illegal parameter in CPOP causes COMPASS to ignore 
the CPOP and issue an error flag. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELOS 

sytx 

CPOP 

ctl, val,reg,type 


sytx rhe syntax consists of a mnemonic operator and variable field descriptors. 

'I’he mnemonic operator consists of two letters. The first can be any letter. 

The second letter can be a register designator: A, B, or X, in which case, 
the operation field of the instruction is recognized as cAn, cXn, or cBn, 

(c is a unique character; n is 0-7); or the second letter can be any other letter, 
in which case the operation field of the instruction is recognized simply by a 
two-letter mnemonic, such as F.Q. 

The variable field descriptors define the order of appearance of all registers, 
expressions, and subfield separators that comprise the variable field of the 
instruction being described. It consists of none, one, two, or three of the 
following 22 subfield descriptors. Q represents an expression. An r represents 
a register letter (A, B, or X). A comma separates two descriptors; a blank 
terminates the syntax. 


void 

Q 

r 

rQ 

-r 

-rQ 


ri+r2Q 


-ri+r2Q 

r *r 

1 2 

ri*r2Q 

-r *r 

1 2 


^l/^2 

ri/r2Q 
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For example, to describe -X3*B1, the descriptor, -rj*r 2 , would be written as -X*B whereas, to 
describe 32+ALPHA, the descriptor rQ would be written as BQ. 


ctl 


val 

reg 


Control of instruction assembly. 


ctl 


Significance 


0 

1 

2 

3 

4 

5 

6 

7 


15-bit instruction 
30-bit instruction 

15-bit instruction, force upper before assembly 
30-bit instruction, force upper before assembly 
15 bit instruction, force upper after assembly 
30-bit instruction, force upper after assembly 

15-bit instruction, force upper before and after 
assembly 

30-bit instruction, force upper before and after 
assembly 


An evaluatable expression specifying a 9-bit operation code; if the base is M, 
val is assumed to be octal. 


Three octal digits specifying the order from left to right into which register 
numbers are to be inserted into the i, j, k portions of a 15-bit instruction, or 
into the i and j portions of a 30-bit instruction. If the assembly base is M, 
reg is assumed to be octal. 

1 Register number obtained from operation field 

2 Number of second register or only register in 

variable field 

3 Number of first of two registers in variable field 

0 Set field to 0 


6 
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An evaluatable expression specifying an integer value that COMPASS interprets 
as follows; 


6 Restrict the instruction being defined to the 6000 Series and 
CYBER 70/Models 72, 73, and 74; COMPASS sets an error 
flag if the instruction being defined is used when MACHINE 7 
has been specified. 

7 Restrict the instruction being defined to 7600 or the CYBER 
70/Model 76; COMPASS sets an error flag if the instruction 
being defined is used when MACHINE 6 has been specified. 

other The instruction is not restricted to a machine type, 
or 

omitted 

If base is M, type is assumed to be octal. If type is omitted, the comma 
preceding it can be omitted also. 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARlAfilE 

COMMENTS 




1 


n 


bo 





SAX + D 

SXXO 

CPOP 

CPOP 

* 

0,5308,1326 

1,7208,1208 

'DEFINES 

[defines 

SAI 

SXI 

XJ+BK 

XJ+K 

53731 

7231000003 


TAG 

• 

SiA7 

SX3 

X3+U1 

Xl+3 
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6.2.2 C?SYN-SYNONYMOUS CPU INSTRUCTION 


The CPSYN pseudo instructioi renders an instruction with the syntax given in the location field 
synonymous with the instruction having the syntax specified in the variable field. The only limit to 
the number of CPU instructions that can be made synonymous is the size of the operation code table 
f41 23 entries). 

Format 


LOCATION 

OPERATION 

VARIASIE SUBfiELDS 

sytXj^ 

CPSYN 

sytxg 


syt: Syntax of a CPU instruction (see CPOP for legal forms). If this syntax is 

^ already in the operation code table, the table entry for sytXg takes precedence 

over the old table entry for sytx^ without notification. 

sytt Syntax of a CPU instruction for which there must be an entry in the operation 

^ code table. Following the CPSYN, an instruction in either sytXj or sytX 2 

produces an octal instruction of the format described by the entry for sytx^,. 

6.2.3 PURGDEF —PURGE CPU OPERATION CODE 

The PURGDEF pseudo instruction provides a means of disabling syntactically-identified operation code 
entries for the duration of the current assembly. 

Format: _ 


LOCATION 

OPERATION 

VARIABLE SUBPIEIOS 


PURGDEF 

sytx 


sytx Syntax of a CPU instruction (see CPOP for legal forms), 

A location field symbol, if present, is ignored. 
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MICROS 
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The COMPASS micro capability enables the programmer to symbolically refer to a defined character 
string. When used in conjunction with IFC, DUP, STOPDUP, and SET pseudo instructions, micro 
strings p ?ovide for varied manipulation of character strings — testing for a particular character, 
counting characters, concatenation of strings, etc. 


Use of a micro definition requires two steps: definition of the character string, and substitution. In 
this discussion, substitution rather than definition is discussed first so that the reader has a better 
understanding of how a definition is used when it is described. 


7.1 MiCRO SUBSTITUTION 

Wherever a micro name between micro marks (^) occurs in a statement other than a comment 
line (* in column 1), the assembler substitutes the micro before It interprets the statement. If 
column 72 of the last card read is exceeded as a result of micro substitution, the assembler 
creates up to a maximum of 9 continuation cards, beyond which it discards excess characters 
without aotification on the listing. No replacement takes place if the micro name is unknown or if 
one of the micro marks has been omitted. If the micro name is unknown, the assembler flags a 
nonfatal assembly error. If the micro name is null, (that is, the two micro marks are adjacent), 
then 

1. Both micro marks are deleted, and 

2. No error flag is set 

Example: 

A micro Identified as NAM is defined as the 7 characters: 

ADDRESS 

A reference to NAM Is in the variable field of a line: 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


M 

18 

30 


LOG 

SAl 

#NAM<+4 



However, before the line is interpreted, COMPASS substitutes the definition for NAM producing the 
following line: 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


II 

18 

|30 


LOG 

SAl 

ADDRESS+4 [ 


NOTE 
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Unless the A option of the LIST pseudo instruction is 
enabled, the listing depicts the instruction as it was 
before the substitution took place. 
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7.2 MICRO DEFINITION 

Pseudo iastructions specifically designed for the purpose of defining micros are: MICRO, OCTMIC and 
DECMIC. In addition, the following pseudo instructions optionally define micros: BASE, CODE, and 

QUAD. Also, system or built-in micros are automatically defined by COMPASS at the start of each 
subprogram assembly. 

7.2.1 MICRO-DEFINE MICRO 

The MICRO pseudo instruction defines a character string and assigns a name to that string. 

Format: 


lOCATlON 

OPERATION 

VAKIABLE SUBfIElDS 

micname 

MICRO 

n^, ng , dstringd 


micname Name by which definition is called; 1-8 characters 

*^1 Absolute evaluatable expression specifying starting character in string; when the 

base is M, COMPASS assumes that n^^ is decimal. 

^2 Absolute evaluatable expression specifying number of characters; when the base 

is M, COMPASS assumes that n^ is decimal. 

dstringd Delimited character string. The delimiter d is a character not used in the 

string. 

Counting the first character after d as character 1, the assembler forms the string by extracting n, 
characters starting with character n^^. If the second delimiting character occurs before count n^ is 
exhausted, the defined string terminates at that point. If n^^ is greater than zero and no is omitted, zero 

or negative, the defined string includes all the characters from n to the closing delimiter (see second 
example). 

If n^ Is omitted, zero, or negative, the defined string is empty; no substitution takes place when the micro 
name is referred to. That Is, 1 X 2 and the character string are ignored, 

A previouslj' defined micro can be a part of a micro definition; one micro can be defined as a substring 
of another (see third example). 

A micro can combine previously defined micros or can be a subset of another. Also, a micro defined 
originally as one character string can be redefined subsequently with a different character string. After 
the redefinition, the original character string is inaccessible. 

If nj^ or n 2 is negative, the assembler generates a 7-type error. 

Examples: 

1. The following MICRO defines NAME as the 19 characters beginning with A and ending with G. 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

1 


11 

18 |30 


N flHE 

MICRO 

1.19f*ALPHANUHPRIC STRING* 
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2. This example illustrates a blank character count. The defined string begins with A and is 
terminated by the closing delimiter. 



LOCATION 

OPEKATtON 

VAtlABtE COMMENTS 

1 



18 [30 


MICKY 

MICRO 

1, , ♦ALPHANUMERIC STRING^ 


3. One micro can be defined as a substring of another. 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

} 


1 ) 

18 

|30 






NAMl 

• 

MICRO 

• 

1,26,•MAJOR 

• 

'ALPHANUMERIC STRING* 


•1 

NflM? 

• 

• 

MICRO 

• 

• 

7, ,*#NAM1^* 

ISAME STRING AS IN EXAMPLES 1 At 


4. One micro can combine others. 



LOCATION 

OPERATION 

VARIABLE COMMENTS 


— 

n 

18 I 30 


NSMl 

NAM? 

N4M7 

MICRO 

MICRO 

MICRO 

1,12,$ALPHANUMERICS 

1,7,X STRINGX 

1, , + ENAMl##NAM23H- COMBINES NAMl AND NAM2 


5. A micro name can be redefined. 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


M 

It 

|30 




- 1 - 


MSG 

MICRO 

1,6,*STRING*1 


• 

• 

• 

• 

• 

. jCODE USING FIRST DEFINITION 


MSG 

• 

MICRO 

• J 1 

1,19,•ALPHANUMERIC #MSG#* 

1 


• 

• 

• 


. |C00E USING SETOND DEFINITION. 


« 

« 

J 

tFIPST OEFINTTION TS INACCESSIBL 

1 


6. Micro substitution takes place before a line is assembled or examined for syntax. Thus, 
the following is possible. 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


} 


11 

18 

30 







NAh 

MICRO 

• 

1,25,* LOG 

SAl 

ADDRESS** 

* 

NAM# 1 

LCC 

• 

• 

SAl 

adopess+1 
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7.2.2 DECMIC - DECIMAL MICRO 


Using a decimal conversion, the DECMIC pseudo instruction converts the expression into a character 
string to be saved under the name specified. 

Format: 


LOCATION 

OPERATION 

VAdlABlE SUBFIEIDS 

micname 

DECMIC 

aexp,n 


micname Name by which definition is called; 1-8 characters 

aexp Absolute evaluatable expression 

n Optional absolute evaluatable expression specifying number of characters 

in the defined string. The defined string is a maximum of 10 characters 
regardless of the magnitude of n. When base is M, COMPASS assumes that 
n is decimal 

If n is omitted or has a zero value, the micro contains the number of characters 
indicated by the conversion to a maximum of 10 characters. If the converted 
expression has more than n (or 10) digits, the most significant digits are 
truncated. If the value has fewer than n digits, the string is right justified and 
filled with leading zeros. All numbers are treated as positive. 

Example: 



LOCATION 

OEESATION 

VABIABLE COMMENTS 

! 


II 

IB Iso 


fv 

OFCMIC 

R.e ] 


ISYMBL 

symbl 

MICRO 

MICRO 

STORAGE NEEDED^ 

STORAGE NEEDED* 


7.2.3 OCTMIC - OCTAL MICRO 

Using an octal conversion, the OCTMIC pseudo instruction converts the value of the expression into a 
character string to be saved under the name specified. 
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Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 

micname 

OCTMIC 

aexp, n 


Name by which definition is called; 1-8 characters 
Absolute evaluatable expression 

Optional absolute evaluatable expression specifying number of characters 
in the string. 'ITie defined string is a maximum of 10 characters regardless 
of the magnitude of n. When base is M, COMPASS assumes n as a decimal. 
If n is omitted or has a zero value, the micro contains the number of 
characters indicated by the conversion to a maximum of 10 characters. 


If the converted expression has more than n (or 10) digits, the most significant digits are tnmcated. 
If the value has fewer than n digits, the string is right justified and filled with leading zeros. All 
numbers are treated as positive. 

Example: 


— 

lOCATlON 

OPEHATION 

VA«IA81E COMMENTS 

1 


tl 

II Ito 


VI 

OCTMIC 

L-1-—-—-- 

Bt6 1 

1 

1 

1 


51 

isi 

MICRO 

MICRO 

1 

1., *#V1# ADDITIONAL STORAGE NEEDED* 

1., *002000 ADDITIONAL STORAGE NEEDED* 


7.3 PREDEFINED MICRO NAMES 

Several standard micros are predefined by the COMPASS assembler. They are available for everj 
assembly. The programmer simply writes the micro reference as desired. 

These micros are automatically defined at the beginning of each assembly, and have the default values 
specified below until they are redefined by the programmer; thereafter, the programmer’s definition 
holds until the start of the next assembly. 
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7.3.1 DATE 


The DATE micro contains the current date in 10 characters in the following form as obtained from the 
operating system: 

Ayr/mo/dy. 

The micro reference is ^DATEA 


7.3.2 JDATE 

The automatic value of the JDATE micro is five digits yyddd, where yy is the year and ddd is the day 
of year at the time of assembly. Thus, JDATE is the Julian date form of DATE. 

'^he micro reference is s^JDATEA 


7.3.3 TIME 

The TIME micro contains the current time of day in 10 characters in the following form as obtained 
from the operating system: 

A hr. min. sec. 

The micro reference is ^TIMEA 
Example: 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


n 

18 

Uo 



TITLE 

PROGRAM 

ASSEMBLED ON /DATE# AT/TIME# 


7.3.4 BASE 

The automatic value of the BASE micro is a single letter D, M, or O, corresponding to the number 
base currently in effect(specified by the most recent BASE pseudo instruction); it is initially D. 

The micro reference is 9^BASE;^. 
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7.3.5 CODE 


The automatic value of the CODE micro is a single letter A, D, E, or I, corresponding to the 
character code currently in effect (specified by the most recent CODE pseudo instruction)* it is 
initially D. 

The micro reference is ?^CODE?^. 


7.3.6 QUAL 

The automatic value of the QUAL micro is 0 to 8 characters comprising the qualifier symbol 
currently in effect (specified by the most recent QUAL pseudo instruction); it is null initially and 
whenever the blank qualifier is in effect. 

The m.cro reference is 9^QUAL^. 


7.3.7 SEQUENCE 

The automatic value of the SEQUENCE micro is 18 characters comprising the sequence field (card 
columns 73-90) of the first line of the COMPASS source statement most recently read from the main^ 
source input file. Thus, if the current statement was read from the main source input file, SEQUENCE 
is the sequence field of the first line of the statement. However, if the current statement is generated 
(i.e., part of a macro call expansion, DUP expansion, etc.) or is read from a different file via the 
XTEX'; pseudo instruction, then SEQUENCE is the sequence field of the first line of the statement most 
recently read from the main source input file. 

The micro reference is j^SEQUENCE?^. 


7.3.8 MODLEVEL 

The automatic value of the MODLEVEL micro is the value (up to 9 characters) specified by the ML 
parameter on the COMPASS control card. If no ML parameter is present, the automatic value ol the 
MODLEVEL micro is equal to that of the JDATE micro. When COMPASS is called by a compiler to 
process embedded COMPASS subprograms, the automatic value of the MODLEVEL micro is supplied 
by the calling compiler. The MODLEVEL micro is intended to be used when assembling a compiler 
(or COMPASS itself), to provide the compiler modification level to be placed in word 6 of each PRFX 
table in the binary output written by the compiler. 

The micro reference is ^MODLEVEL?^. 
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7.3.9 PCOMAAENT 


The automatic value of the PCOMMENT micro is the value specified by the PC parameter on the 
COMI’ASS control card, with characters truncated from the right or blanks appended to the right, as 
ncces.sary, so that the micro’s length is exactly 30 characters. If no PC parameter is present, the 
automatic value of the PCOMMENT micro is 30 blanks. When COMPASS is called by a compiler to 
process embedded COMPASS subprograms, the automatic value of the PCOMMENT micro is supplied 
by the calling compiler. The PCOMMENT micro is intended to be used in a COMMENT pseudo in¬ 
struction to specify words 8 - 10 of the PRFX table in the binary output. It may also be used, in 
conjunction with the *F special symbol, to determine compiler options (debug mode, rounded arithme¬ 
tic, etc.) in effect at the time of assembly. 

The micro reference is 5>^PCOMMENT^. 
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CPU SYMBOLIC MACHINE INSTRUCTIONS 


8 


COMPASS recognizes symbolic notation for all CYBER 70 Series Central Processor Unit Instructions, 
all 7600 Central Processor Unit instructions and alt 6000-Series Computer Sj'stems Central Processor 
Unit instructions. 

The assembler identifies each symbolic instruction according to its syntax and generates a one parcel 
15-bit instruction or a two parcel 30-bit instruction. The object code for an instruction is generated 
in the block in use when the instruction is encountered. 


8.1 MACHINE INSTRUCTION FORMATS 


Figures 6-1 and 8-2 illustrate the formats for CPU 15-bit and 30-bit instructions generated by the 
assembler. 


gh 

1 

j 

k 

14 

08 

05 02 00 


Figure 8-1. CPU 15-Bit Instruction Format 


gh 

1 

□ 

■ ' T ■ II - . — 

i K 


29 23 20 17 14 00 

Figure 8-2. CPU 30-Bit Instruction Format 


gh 6-bit instruction code 

ghi 9-bit instruction code 

i 3-bit code specifying one of eight designated registers (e. g. ,Ai) 

j 3-bit code specifying one of eight designated registers (e. g. ,Bj) 

k 3-bit code specifying one of eight designated registers (e. g. , Bk) 

K 18-bit integer value used as an operand, address of an operand, or branch destination 

address. 

jk 6-bit integer value specifying a shift count or mask count 

Figure 8-3 illustrates possible arrangements of one and two parcel instructions in a 60-bit CPU 
instruction word. Generally, the assembler does not allow a two-parcel instruction to begin in the 
fourth parcel of a word. However, the assembler may generate a 30-bit instruction in a fourth 
parcel when all of the following are true: 

1. The assember is at the fourth parcel (position counter is 15) 
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2, I he instruction does not include K. Note that if K is included in the syntax and reduces to zero, 
it requires 30 bits because the evaluation of K takes place in the second pass whereas the space 
for the instruction is reserved in the first pass. 

3. The instruction does not have a location field symbol or is not otherwise forced upper. 

When a two parcel instruction begins in the last parcel of a word, the CYBER 70/Model 76 or 7600 
executes it as if there were a fifth parcel in the instruction word and that parcel contained all zeros. 

On the 6400 or CYBER 70/Model 73, this condition causes an error exit. On the 6600 or CYBER 
70/Model 74, the CPU takes the first parcel of the current Instruction. 

Before it assembles an instruction that must begin in the first parcel (forced upper) and after it 
assembles an instruction that requires the instruction following it to be forced upper, the assembler 
completes a word as follows: 


Lower 15 bits remain 
Lower 30 bits remain 
Lower 45 bits remain 


They are packed with a one parcel NO (pass) instruction 
They are packed with a two parcel SBO BO+K instruction 
They are packed with a NO instruction and an SBO BO+K instruction 


First Second Third Fourth 

Parcel Parcel Parcel Parcel 



Figure 8-3. Arrangements of Instructions in a 60-bit CPU Word 
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8.2 l^!STRUCTION EXECUTION 


8,2.1 6600/6700AND CYBER 70/MODEL 74 EXECUTION 

After an exchange jump start by a PPU and CPU program, CPU instructions issue automatically iu the 
ori yin.i: sequence, to an 8~woid instruction stack. The stack can hold a program loop consisting cf up r, 
26 15-bu instructions and one 30-bit instruction. 

Instructi in.= are read from the stack one at a time and issued to the functional units (table 8-1) for 
e.xecutior,. A scoreboard reservation system in CPU control keeps a current log of which units and 
operating registers are reserved for computation results from functional units. 

Each functional unit executes several instructions, but only one at a time. Some branch instructions 
require two units, the second unit receives direction from the branch unit. 

The "f i':r- '-ng instruction.s varies from the maximum of one instruction every 100 nanoseconds 
(one minor cycle). Sustained issuing at this rate may not be possible because of functional unit anu CM 
conflict c>r because of serial rather than simultaneous operation of units. Program run time can be 
decreased by efficient use of the units. Instructions that are not dependent on previous steps may oe 
arranged or nested in program areas where they may be executed concurrently with other operations to 
eliminate dead spots in the program and increase the instruction issue rate. 

Fhe following steps summarize instruction issuing and execution: 

• An instruction is issued to a function unit when: 

Specified functional unit is not reserved 

Specified result register is not reserved for a previous result 

• Instructions are issued to functional units at minor cycle intervals when no reservation conflicts 
are present. 

• tn.struction execution starts in a functional unit when both operands are available. Execution is 
delayed when an operand is a result of a previous step which is not complete. 

« No delay occurs between the end of a first unit and the start of a second unit which is waiting for 
the results of the first. 

• After a branch instruction no further instructions are issued until instruction has been executed. 

!n the execution of a branch instruction, the branch unit uses: 

Increment unit to form the instructions that branch to K + Bi and branch to K if Bi ... 

Long add unit to perform the instructions that branch to K if Xj ... 

Time spent in the long add or increment units is part of total branch time. 

Read central memory access time is computed from the end of increment unit time to the time an 
operand is available in X operand register. Minimum time is 500 nanoseconds assuming no central 
memory bank conflict. 

+ The 6700 also includes a 6400-type central processor unit 
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TABLE 8-1. CYBER 70/Model 74 and 6600/6700 FUNCTIONAL UNITS 


UNIT 

GENERAL FUNCTION 

Branch 

Handles all jumps or branches from the program. 

Boolean 

Handles the basic logical operations of transfer, logical product, 
logical sum, and logical difference. 

Shift 

Executes operations basic to shifting. This includes left (circular) 
and right (end-off sign extension) shifting, and normalize, pack, and 
unpack floating point operations. The unit also includes a mask 
generator. 

Floating Add 

Performs single or double precision floating point addition and 
subtraction on floating point operands. 

Long Add 

Performs addition and subtraction of two 60-bit fixed point operands 

Floating Multiply 

Performs single or double precision floating point multiplication on 
floating point operands 

Floating Divide 

Performs single precision floating point division of floating point 
operands; also counts the number of 1 bits in a 60-bit word. 

Increment 

Performs one's complement addition and subtraction of 18-bit operands. 
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8.2.2 >200/6400/6500 AND CYBER 70/MODEL 72, 73 EXECUTION 


The 6200, 6400, 6500 and C's BER 70/Model 73 systems CPU has a unified arithmetic vinit, rather 
than separate functional units as in the 6600 system. Instructions in the CPU are executed sequentially. 


For ef icient coding in the central processor unit: 

Always attempt to place jump instructions in the upper portion of the instruction word to avoid both 
the additional time for RNI (2 minor cycles) and the possibility of a memory bank conflict with. 

(P - 1). 

Where possible, place load/store instructions in the lower two portions to avoid lengthening 
execution times, 

Reading the next instruction words of a program from central memory, RNI, is partially concurrent 
with ins .ruction execution. RNI is initiated between execution of the first and second instructions of the 
word oe ng processed. Initiating RNI operation requires two minor cycles; the remainder of the RNI 
is parallel in time with execution of the remaining instructions in the word: 



In calculating execution times, two minor cycles are added to each instruction word in a program to 
cover the RNI initiation time. Exceptions are the return jump and the jump instructions (in which the 
jump condition is met) when they occupy the upper position of the instruction word. Since the times for 
these instructions already include the time required to read the new instruction word at the jump 
address, no additional time is consumed (AppendixA). 
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Example: 


Jump to K (met) 

Pass 

Pass 


Add 1 

Add 2 

Load 

Load 


Instruction 

Minor Cycles Required 

Jump 

13 

Add 1 

5 

RNI Initiation 

2 

Add 2 

5 

Load 

12 

Store 

10 

Total Time 

47 Minor Cycles 


After RNI is initiated (between the first and second instructions of the word), a minimum of eight 
minor cycles elapses before the next instruction word is available for execution. Even if the lower 
order positions of the word should require less than eight minor cycles, a minimum of eight minor 
cycles is allowed. 

Example: 


Jump to K 
(not met) 


P + 1 


Pass 


Pass 


8.2.3 7600 AND CYBER 70/MODEL 76 EXECUTION 

Execution of an arithmetic or logical machine instruction takes place in one of nine functional units in 
the computation section of the CYBER 70/Model 76 or 7600 CPU. Each is a specialized unit with 
algorithms for a portion of the CPU instruction execution. Table 8-2 lists the general function of each 
unit. A number of functional units may be in operation at the same time. 
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TABLE 8-2. CYBER 70/Model 76 and 7600 FUNCTIONAL UNITS 


UNIT 

GENERAL FUNCTION 

Boolean 

Handles the basic logical operations of transfer, logical product, logical 
sum, and logical difference. It also performs the pack and unpack 
floating point operations. | 

Shift 

Executes operations basic to shifting. This includes left (circular) 
and right (end-off sign extension) shifting, and mask generation. 

Normalize 

Performs the normalize operations. | 

Floating Add 

Performs single or double precision floating point addition or subtraction 
on floating point operands. 

' Lone Add 

Performs integer addition or subtraction of two 60-bit fixed point | 

operands. | 

Floating Multiply 

Performs single or double precision floating point multiplication on 
floating point operands. 

Floating Divide 

Performs single precision floating point division of floating point 
operands. 

Popv lation Count 

Counts the number of 1 bits in a 60-bit w'ord. 

j Inci'jment 

Performs one's complement addition and subtraction of 18-bit operands, i 


A functional unit receives one or two operands from operating registers at the beginning of instruction 
execution and delivers the result to the operating registers after performing the function. The functional 
units do not retain any information for reference in subsequent instructions. The units operate in three- 
address mode with source and destination addressing limited to the operating registers. 

Except for the floating multiply and divide units, all functional units have one clock period segmentation. 
This means that the information arriving at the unit, or moving within the unit, is captured and hcid 
in a new set of registers at the end of every clock period. It is therefore possible to start a new set 
of operands for unrelated computation into a functional unit each clock period even though the unit n.ay 
require more than one clock period to complete the calculation. This process may be compared to a 
delay line in which data moves through the unit in segments to arrive at the destination in the proper ^ 
order but at a later time. All functional units perform their algorithms in a fixed amount of time. No 
delays are possible once the operands have been delivered to the front of the unit. 

Ihe floating multiply unit has a two clock period segmentation. Operands may enter the multiply unit 
in any clock period providing there was no multiply operation initiated in the preceding clock period. 

The floating divide unit is the only functional unit in which an iterative algorithm is executed. There is 
little segmentation possible in this unit. However, to increase execution speed, the beginning of a new 
divide operation can follow a previous divide operation by 18 clock periods for a gain of 2 clock periods. 

Instructions involving storage references for operands or program branching are difficult to time. 
Program branching within the instruction stack causes no storage references and small program loops 
can therefore be precisely timed. 
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8.3 OPERATING REGISTERS 


Twenty-four registers minimize memory references for arithmetic operands and results: 


Function 

Identity 

Length 

Number 

Operand Registers 

XO - X7 

60 Bits 

8 

Address Registers 

AO - A7 

18 Bits 

8 

Index Registers 

BO - B7 

18 Bits 

8 


A register is reserved if it is the destination of an instruction that has been initiated but has not been 
completed. A register is free in the clock period (or minor cycle) following the store into it. 

8.3.1 X REGISTERS 

Eight 60-bit X registers in the computation section of the CPU designated XO, XI,.,. ,X7 are the 
principal data handling registers for computation. Data flows from these registers to the SCM (CM) 
and the LCM (not ECS). Data also flows from SCM (CM) and LCM (not ECS) into these registers. 

All 60-bit operands involved in computation must originate and terminate in these registers. 

Operands and results transfer between SCM (CM) and these registers as a result of placing SCM (CM) 
into corresponding address registers. 

On the CYBER 70/Model 76 and 7600, the X registers also serve as address registers for referencing 
single words from LCM. XO is used as the LCM relative starting address in a block copy operation. 


8.3.2 A REGISTERS 


Eight 18-bit A registers in the computation section of the CPU, designated as AO, A1.A7, are 

essenhally SCM (CM) operand address registers. With the exception of AO and XO, A registers are 
associated one-for-one with the X registers. Placing a quantity into an address register A1 - A5 
causes an immediate SCM (CM) read reference to that relative address and sends the SCM (CM) word 
to the corresponding operand register XI - X5. Similarly, placing a value into address register A6 

or A7 causes the word in the corresponding X6 or X7 operand register to be written into that relative 
address of SCM (CM). 


The AO and XO registers operate independently of each other and have no connection with SCM (CM). 
AO is used as the relative SCM (CM) starting address in a block copy operation and for scratch pad or 
intermediate results. 


8.3.3 B REGISTERS 

Eight 18-bit B registers in the computation section of the CPU designated as BO, B1.B7 are 

primarily indexing registers for controlling program execution. Program loop counts can be incremented 
and decremented in these registers. 
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Prograi : addresses may be modified on the way to an A register by adding or subtracting B register 
quantitif s. The B register also holds shift counts for pack and normalize operations and the channel 
number for channel status requests. 

BO always contains positive zero; that is, BO is held clear. Often as a programming convention, B1 
or B7 contains positive 1. See the Bl=l, the B7=l, and the R= pseudo instructions. 


8.4 SYMBOLIC NOTATION 

This section describes notation used for coding symbolic CPU machine instructions. Instructions are 
listed according to octal sequence. Instructions unique to a computer system are identified as such. 
These instiaictions can be assembled on any machine but will execute properly on the noted machine only. 
For details and special conditions arising during instruction execution, refer to the relevant hardware 
sj'stem reference manual. 

The location field of a symbolic machine instruction optionally contains a location symboL WTien the 
symbol is present, it is assigned the value of the location counter after the force upper (if any) occvns. 

The operation field of a symbolic CPU machine instruction contains a mnemonic operator, the last tw'o 
charactf rs of which are often a register designator. 

The var: able field contains one, two, or three subfields. For 15-bit instruction, subfields take the 
forms: 


r 


r,r 
r op r 
-r op r 


r is a register designator 

op is a register operator + - * / 

jk is an absolute expression specifying a shift count or mask bit count. If 
the expression value is in the range -60 to -0, inclusive, COMPASS adds 60 to it. 
If it is less than -60 or greater than 63, COMPASS sets a warning flag and uses 
the low-order 6 bits of the expression value. 


For a 30-bit instruction. 


subfields take the forms: 


The single subfield contains an absolute, relocatable, or external expression 
that does not include a register. 

The single subfield contains an absolute, relocatable, or external expression 
that includes a register designator; op is an expression operator: 

+ - * / 

One subfield contains a register designator, the other subfield contains an 
absolute, relocatable, or external expression that does not include a register 
designator. 

Two subfields contain register designators; a third contains an absolute, 
relocatable, or external expression that does not include a register. 
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In the fonnats and examples, K reduces to an 18-bit value that represents one of the following in pass 
two: 

An absolute address or a word count 
An external symbol an integer value 

An address that is relocatable relative to the program origin or common block origin. 

An address of a literal 

If K is negative, the assembler inserts the one's complement of the integer value in the K portion of the 
instruction. 


In the descriptions of the formats, _j^K designates that the evaluation of all non-register elements can 
result in a positive or negative value for the expression (see section 2. 8. 2 Evaluation of Expressions). 
Use of to represent the integer portion of the expression does not imply that the first term oper¬ 
ator in the expression is an expression operator. If you consider that a and b are terms in expression 
K, then tK indicates that the sum of the values of a and b is positive and -K indicates that the sum of 
the values is negative. Thus, -K does not mean that a-b would become -a+b. 

In the following example, the symbol XRAY has the value 407 . The first term operator (-) forms the 

value 777370 . Subtracting 1 from this results in 777367 or a -K (-410 ). 

o 8 8 


Code Generated 


LOCATION 

OPERATION 

VARlABia 

COMMENTS 


1 


n 

16 

1 30 

13 721277736/’ 



SXl 

f-- 1 -- 

X2-XRAY-1 f 

1 


Unless otherwise noted, subfields can be in any order. COMPASS also allows m added degree of 
flexibility by allowing the variable subfields of an instruction to be written in the operation field with 
each subfield preceded by a comma. For example; 


tlocle Generated 



LOCATION 

OPERATION 

VARIABLE 


COMMENTS 

1 


n 

18 


ho 



UXl 

-1-- 

1 


can be written 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


n 

18 

|30 

261?3 



IIXI, 8? 

iil -^- 


The instructions are identical to the assembler. 
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Similarlthe following instructions are regarded as identical. Use of this feature is optional. 




LOCATION 

OPERATION 

VAftlABlE COMMENTS 


) 


II 

18 llO 

04230 .0641 



•1 

E3 

---j- 

82,B3,t< 1 

04230 .0641 



Ea,B2 

33,< 1 

04230 .0641 



EQ,B2,! 

53 K 1 

* 

0423010641 



1 

EQ,32,B3,K j 


8.4.1 PROGRAM STOP OR EXCHANGE JUMP INSTRUCTION 

(CVBER 70/MODEL 72, 73, 74 OR 6000 SERIES) 

The CEJ/MEJ Panel Switch determines whether this instruction causes the central processor unit to 
halt or tc execute an exchange jump. The DISABLE position disables the central exchange jump or 
the monitor exchange jump. In this case, PS halts the central processor unit at the current step in 
the program. An exchange jump is necessary to restart the central processor unit. The ENABLE 
position rmables the jump capabilities. In this case, PS causes an exchange jump to monitor address 
(MA) in tie exchange package. 

The contents of the location field become a sub-subtitle on the assembler listing. The assembler 
forces upper before and after assembling a PS instruction. 

Formats: CYBER 70/Model 74 or 6600/6700 Functional Unit: Branch 


Operation 

Variable 

Description 

Size 

Octal Code 

PS 


Program stop or exchange jump to (MA) 

30 bits 

00000 00000 

P3 

K 

Program stop or exchange jump to (MA) 

30 bits 

OOOOK 


Example: 


Code Generated 


1 

LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


M 

le 

1 30 

ooDoaoooon 




-- 



PS 

1 j 

1 
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8.4.2 ERROR EXIT INSTRUCTION (CYBER 70/MODEL 76 OR 7600) 


ES execution is treated as an error condition and the machine sets the prc^ram range condition flag 
in the PSD register. The condition flag then generates an error exit request which causes an exchange 
jump to address (EEA). All instructions issued prior to this instruction are run to completion. Any 
instruction following this instruction in the current instruction word is not executed. When all operands 
have arrived at the operating registers as a result of previously issued instructions, an exchange 
jump occurs to the exchange package designated by (EEA). 

The i, j, and k designators, which are ignored by the computation section, are set to zero by the 
assembler. The program address stored in the exchange package on the terminating exchange jump is 
advanced one count from the address of the current instruction word (P=P+1). This is true regardless 
of which parcel of the current instruction word contains the error exit instruction. 


The error exit instruction is not intended for use in user program code. The program range condition 
flag is set in the PSD register to indicate that the program has jumped to an area of the SCM field which 
may be in range but is not valid program code. This should occur when an incorrectly coded program 
jumps into an unused area of the SCM field or into a data field. The program range condition flag is 
also set on the condition of a jump to address zero. These conditions can be determined on the basis 
of the register contents in the exchange package. The existence of an error exit condition resulting 
from execution of this instruction can thus be deduced. 

The location field of an ES instruction becomes a sub-subtitle on the assembler listing. 


Format: Functional Unit: None 


Operation 

Variable 

Description 

Size 

Octal Code 

ES 


Error exit to EEA 

15 bits 

00000 

ES 

K 

Error exit to EEA 

15 bits 

00000 


Example: 


Code Generated 


LOCATION 

OPERATION 

variable 

COMMENTS 


1 


n 

18 

|30 





-J- 

00000 



ES 

1 

1 
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8.4.3 tETURN JUMP INSTRUCTION 


WTien this instruction is execu ed, an unconditional jump to the current address plus one [(P)+l)] is 
stored in the upper half of relative address K in SCM and control then transfers to K+1 for the next 
instruction. The lower half of the stored word is all zeros. The instruction always branches out of 
the instruction stack and voids all instructions currently in the instruetion stack. 


After th( instruction is executed the octal word at K is; 


Address K | 

0 4 0 0 

P + 1 

~r' 

0000000000 


59 


29 

00 


Bi=Bj 


This instruction is intended for transferring control to a subroutine between e.xecution of the current 
instruction word and the following instruction word. Instructions appearing after the return jump 
instruction in the current instruction are not executed. The called subroutine must exit at address K 
in CM (SCM). A jump to address K of the branch routine rehirns the program to the original sequence. 
The assi;mbler sets the unused j designator to zero. 

A force upper occurs after the instruction is assembled. 


CYBER 70/Model 74 or 6600/6700 Functional Unit: Branch 
Format: CYBER 70/Model 76 or 7600 Functional Unit; None 


Operatic n 

Variable 

Description 

Size 

Octal Code j 

RJ 

K 

Return jump to K 

30 bits 

OlOOK 


Example: 


Code Generated 

■n 

J 

tOCATION 

OPERATION 

VARIASIE 

COMMENTS 





n 

18 

! 30 



n 


RJ 

HPLP 
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8.4.4 ECS INSTRUCTIONS (CYBER 70/MODELS 72, 73, 74 OR 6000-SERIES) 

These in.structions initiate either a read or write operation to transfer (Bj) + K 60-bit words between 
extended core storage (ECS) and central memory (CM). The initial ECS address is (XO) + 
the initial CM address is (AO) + 

The assembler forces upper before assembling an RE or WE instruction. 

Three error conditions cause an error exit to the lower-order 30 bits of the instruction word 
containing the RE or WE instructions. These 30 bits should always hold a jump to an error 
routine. The conditions are: 

1. Parity error(s) when reading ECS. If a parity error is detected, the entire block of data 
is transferred before the exit is taken. 

2. The ECS bank from/to which data is to be transferred is not available because the bank 
is in maintenance mode, or the bank has lost power. If either of these conditions exists 
on an attempted read or write, an immediate error exit is taken. 

3. An attempt to reference a nonexistent address. On an attempted write operation, no data 
transfer occurs and an immediate error exit is taken. If the attempted operation is a 
read, and addresses are in range, zeros are transferred to central memory. This is a 
convenient high-speed method of clearing blocks of central memory. 

For additional information about these instructions, refer to the CONTROL DATA® CYBER 70 
Computer System 7030 Extended Core Storage Reference Manual, Publication No. 60347100. 


Formats: Functional Unit: None 


Operation 

Variable 

Description 

Size 

Octal Code 

RE 

Bj 

Read extended core storage 

30 bits 

OlljO 00000 

RE 

K 

Read extended core storage 

30 bits 

Oil OK 

RE 

Bj+K 

Read extended core storage 

30 bits 

OlljK 

WE 

Bj 

Write extended core storage 

30 bits 

012j0 00000 

M^E 

K 

Write extended core storage 

30 bits 

012 OK 

WE 

BjfK 

Write extended core storage 

30 bits 

012jK 
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Examples: 

Code Generated 

— 

LOCATION 

OPCRATION 

VAHABIE COMMENTS 

1 


11 

18 ho 

Oil noopr'on 



RF 

?onnB 1 

Oil '.no 1C on 



PE 

"71-10 OOP I 

Ol^'iOOlCOn 



vr 

1300B-t-B5 I 


8.4.5 LCM BLOCK COPY INSTRUCTIONS (CYBER 70/MODEL 76 OR 7600) 

Block copy instructioas move quantities of data between LCM and SCM as quickly as possible. All 
activity in the CPU other than I/O word requests is stopped during a block copy operation. All 
:nstrvicticns issued prior to a block copy instruction are executed to completion and no further 
iiistructicns issue until the block copy is nearly completed. As a result of these restrictions the 
data flow between LCM and SCM can proceed at the rate of one 60-bit word each clock period. 

When an I/O multiplexer word request for SCM occurs during this transfer, the data flow is 
interrupU d for one clock period. The I/O word address is inserted in the stream of addresses to 
the SAS, ind the addresses for the block copy are resumed with a minimum of a one clock period delay. 
An additional delay will occur if the I/O reference causes a bank conflict in SCM. 
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The length of the block is determined by adding the quantity K to the contents of register Bj. Either 
quantity inay be used as an increment or decrement. The result is an 18-bit integer which is truncated 
to a 10-bit quantity. Thus, a maximum block size is 1777g. (For example, if the result of the add is 
003000g, the instruction transfers lOOOg words.) No error indications are given when this occurs unless 
the field length is exceeded causing a block range error. If the block length is zero, the instruction 
becomes a do-nothing instruction; the condition is not error flagged. 

Relative source or destination addresses begin at (AO) in the SCM and at the relative LCM address 
determined from the lowest order 19 bits of (XO), If (XO) is negative, the 19 bits are treated as a 
positive integer. If the sum of block count exceeds the (FLL), the copy is not 

executed and the LCM block range condition flag is set in the PSD register. Similarly, if the sum of 
(AO) and the block exceeds (FLS), the copy is not executed and the SCM block range condition flag is 
set in the PSD register. 

Any error condition occurring during execution of a block copy instruction causes a flag to be set in the 
PSD regi Ter but does not interrupt the block copy instruction. No further instructions are issued during 
oiock tra isfer of data. Instructions already issued are completed; all other activity, with the exception 
of I/O word requests, stops. 


Formats; Functional Unit: None 


|<jpe ratio'll 

Variable 

' - . ■ -1 

Description 

Size 

Octal Code 

Ihl 

Bj 

Block copy (Bj) words from LCM to SCM 

30 bits 

OlljO 00000 

RL 

K 

Block copy (K) words from LCM to SCM 

30 bits 

oil OK 

RL 

Bj+K 

Block copy (Bj) + K words from LCM to 

SCM 

30 bits 

OlljK 

WL 

K 

Block copy (K) words from SCM to LCM 

30 bits 

0120K 

WL 

Bj 

Block copy (Bj) words from SCM to LCM 

30 bits 

012j0 00000 

WL 

Bj+K 

Block copy (Bj) + K words from SCM to 





LCM 

30 bits 

012jK 


Example: 


Code Generated 


lOCATlON 

-1 

OPERATION 

VARIABLE 

COMMENTS 


1 


11 

18 

Uo 

0115001000 



PL 

1 

1000P<-P5 

--P -—- 

1 

0110002000 



RL 

200'’P 

1 

0124777077 



WL i 

T4-1000 

1 
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8.4.6 EXCHANGE JUMP INSTRUCTION (CYBER 70/MODELS 72, 73, 74 OR 6000-SERIES 

This instruction unconditionally exchange jumps the central processor, regardless of the state of the 
monitor flag bit. Instruction action differs, jiowever, depending on whether the monitor flag bit is 
set or clear. 

Operation is as follows: 

1. Monitor flag bit clear: The starting address for the exchange is taken from the 18-bit Monitor 
Address register. This starting address is an absolute address. During the exchange, the 
monitor flag bit is set. 

2. Monitor flag bit set: The starting address for the exchange is the 18-bit result formed by adding 
K to the contents of register Bj. This starting address is an absolute address. During the 
exchange, the monitor flag bit is cleared. 

For additional information, refer to the Standard Option 10104-A/B/C/D Central and Monitor Exchange 
Jumps for 6600 Reference Manual, Pub. No. 60203200. 


The assembler forces upper before and after assembling an XJ instruction. 

formats: Functional Unit: Branch 


Operation 

Variable 

Description 

Size 

Octal Code 

XJ 


Exchange jump to MA if in program mode 

30 bits 

01300 00000 

XJ 

Bj 

Exchange jump to (Bj); flag set 

30 bits 

013j0 00000 

XJ 

K 

Exchange jump to K; flag set 

30 bits 

0130K 

XJ 

Bj+K 

Exchange jump to (Bj) + K; flag set 

30 bits 

013jK 


Examples: 


Code Generated 


LOCATION 

OPERATION 

variable 

comments 


I 


ll 

le 

I 30 

01 ■'noonooi 



XJ 


—t-- - 

[ 

ni.nooiooo 



XJ 

lOOOB 

I 

ni‘'6non6m 



XJ 

35+6UUR 

I 

I 
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8.4.7 EXCHANGE EXIT INSTRUCTION (CYBER 70/MODEL 76 OR 7600) 


The normal termination for in exchange package execution interval is through execution of an exchange 
instruction (MJ). The exit mode flag in the PSD register determines the source of the e.xchange package. 

This iiistruction has priority over all other types of exchange jump requests. If an I/O interrupt request 
or an error exit request occurred prior to execution of this instruction, it is denied and the exch inge 
jump specified by the MJ is executed. The rejected interrupt request is not lost, however. The 
conditions that caused it are reinstated when the exchange package enters its next execution interval. 

The MI instruction voids the instruction word stack. Any instructions remaining in the stack are not 
executed. 

The system makes no protective tests on the exchange jump address. 


E.xit Mode Flag^Set: When the exit mode flag is set, the MJ instruction causes the current program 
sequence to terminate with an exchange jump to a relative address in the SCM field for the current 
program. The exchange package is located at relative address (Bj) ^ K. An overflow of the lowest 
order >6 bits of this result causes an error condition that is not sensed in the hardware. Should a 
program erroneously execute an exchange exit instruction with an overflow condition, the exchange 
jump sequence begins at the absolute SCM address corresponding to the lowest order 16 bits of this 
sum. This 30-bit form of MJ is privileged to a monitor program. 


^itJVlode Flag Not Set: When the exit mode flag is not set, the object program terminates the execution 
interviil with a 15-bit form of the MJ instruction. The normal exit address (NEA) is the absolute address 
of the exchange package. This is an absolute address in SCM and is generally not in the SCM field for 
the current program. This form of the MJ instruction has a blank variable field; the assembler sets the 
j and k designators to zero. 

This instruction is used for calling a system monitor program for input/output, monitor calls, etc. 

All operating register values, program addresses, and mode selections are preserved in the exchange 
package for the object program so that the object program can be continued at a later time. The program 
addre.ss in the object program exchange package is advanced one count from the address of the 
instruction word containing the exchange exit instruction. I’he monitor program normally resumes the 
object program at this address. 

The assignment of (NEA) is a responsibility of the system monitor program. If (NEA) has more than 
16 bits of significance, the upper bits are discarded and the lower 16 bits are used as the absolute 
address in SCM for the exchange jump. A force upper occurs after the instruction is assembled. 
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Formats: Functional Unit: None 


Operation 

Variable 

Description 

Size 

Octal Code 

MJ 


Exchange exit to NEA if exit flag clear 

15 bits 

01300 

MJ 

Bj 

Exchange exit to (Bj) if exit flag set 

30 bits 

013j0 00000 

MJ 

Bj+K 

Exchange exit to (Bj) + K if exit flag set 

30 bits 

013jK 

MJ 

K 

Exchange exit to K if exit flag set 

30 bits 

0130K 


Examples: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


) 


II 

18 

1 30 

017 0 0 



MJ 


-1- 

1 

0174000'^00 



MJ 

n4+50on 

1 

1 

013<^777477 



MJ 

-30nB+R6 

1 

1 

Qi''noQoe-n n 



MJ 

f>n Oh 

1 


8.4. 8 DIRECT LCM TRANSFER INSTRUCTIONS (CYBER 70/MODEL 76 OR 7600} 

A single word transfer either reads one 60-bit word from LCM and enters this word into an X register 
or writes one 60-bit word directly into LCM from an X register. 

The execution time for transferring a word from LCM to an X register depends on whether the 
requested word already resides in one of the bank operand registers. A read LCM instruction for a 
word not currently residing in a bank operand register will require 17 clock periods for delivering a 
field of eight 60-bit words to the designated X register. A read LCM instruction for a word already 
residing in a LCM bank operand register as a result of a previous instruction will require three clock 
periods to deliver the requested word to the designated X register. Thus, although the first 60-bit 
word will require 17 clock periods, the second through eighth words in the same LCM word require 
three clock perods each, This means that consecutive LCM operands are available, on an average, 
every five clock periods as opposed to SCM operands at eight clock periods. 

The LCM address is determined from (Xki8_oo)- Even if (Xk) is negative, the 19 bits are treated as 
a positive integer. If the address exceeds the field length (FLL), the word transfer does not take 
place and the LCM direct range condition flag is set in the PSD register. Xj is either the source or 
destination register. 

instructions are buffered to the extent that each issues in one minor cycle unless a previous LCM 
reference is in process. When an RX instruction issues, the LCM busy flag is set and remains set 
until the requested word is delivered. 

For a write (WX) instruction, if the word cannot be entered immediately in the proper bank operand 
register, it is held in the LCM write register until the bank operand register is free. 


8-18 


60360900A 








Formats: 


Functional Unit: None 


Operation 

Variable 

Description 

Size 

Octal Code 

RXj 

Xk 

Read LCM at (Xk) and set Xj 

15 bits 

014jk 

WXj 

Xk 

Write (Xj) into LCM at (Xk) 

15 bits 

015jk 


Examples ■ 


Code Generated 


LOCATION 

OPEtATlON 

VARIABLE 

COMMENTS 


1 


1) 

IB 

Iso 

0146'^ 



0X6 

X6 

1 

1 

017 n 



WX7 

xo 

1 

1 


8.4.9 RESET INPUT CHANNEL BUFFER INSTRUCTION (CYBER 70/MODEL 76 OR 7600) 

This instruction is exclusively a 7600 instruction. It initiates a new record transmission from a PPU 
to SCM. This instruction prepares the input channel (Bk) buffer for a new record transmission from a 
PPU to S('M. The instruction clears the input channel buffer address and resets the input channel 
assembly counter to the first 12-bit position in the SCM word. 

This insti'uction is intended to be privileged to an input routine, that is, one that terminates a record 
of incomi ig data and prepares for the next record. 

The input routine removes the data in the input channel buffer and then executes this instruction to 
prepare the buffer for the next incoming record. This instruction is effective only if the monitor mode 
flag is set in the program status register. If the monitor mode flag is cleared, this instruction 
becomes a pass instruction. When this instruction issues, it will execute the required channel functions 
without regard to the current status or activity at the input channel buffer. 

The lowest order four bits of (Bk) are used in this instruction. The higher order bits are ignored. If 
higher order bits are set in (Bk) the lowest order four bits are masked out and used to determine the 
channel number. If (Bk) is zero, this instruction becomes a pass instruction. 
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Two or more conpeciitive RI inslructions referring to different channels will issue in consecutive 
clock periods with no interference resulting in the multiplexer. If two consecutive instructions refer to 
the same channel, they repeatedly perform the same function but do not cause interference in the 
multiplexer. 


Format: Functional Unit: None 


Operation 

Variable 

Description 

Size 

Octal Code 

RI 

Bk 

Reset input channel (Bk) buffer 

15 bits 

0160k 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


II 

18 

iso 


Hi 



-1- 

1 1 '='07 

n 


PI 

P7 1 


8.4.10 SET REAL-TIME CLOCK INSTRUCTION (CYBER 70/MODEL 76 OR 7600) 

This instruction reads the contents of the CPU clock period counter (real-time clock) and places them in 
Bj. The 18-bit clock counter advances one count in two's complement mode for each clock period. The 
2 bit is the overflow bit. The CPU is interrupted when the overflow bit is set. When the interrupt 
is handled, the bit is cleared. It permits measurement of CPU execution. 


Functional Unit: None 


Operation 

Variable 

Description 

Size 

Octal Code 

TBj 


Set Bj to current clock time 

15 bits 

016j0 

TBj 

K 

Set Bj to current clock time; K is ignored. 

15 bits 

016j0 


Exiunple: 


Code Generated 


LOCATION 

OPERATION 

VARIA8U 

COMMENTS 


I 


1) 

18 

loo 

01670 



It6 7 

1-—1-^- 

i 
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8.4.11 kESET OUTPUT CHANNEL BUFFER INSTRUCTION (CYBER 70/MODEL 76 OR 7600) 


This instruction initiates a netv record transmission from SCM to PPU. It clears the output channel 
(Bk) buffer address and disassembly counter, transmits a record pulse over the output channel'data 
path to the PPU, and initiates an SCM reference for the first word to be transmitted. 

This int truction is intended for execution in an output routine to initiate a new record transmission 
over an output channel data path. The output channel buffer is normally inactive when this instruction 
is execi ted. The output channel buffer is loaded with the data for the next record, and this instruction 
is executed to initiate the transmission. The record pulse is transmitted along with the word pulse as 
soon as the first word of data from the SCM is entered in the output channel disassembly register. 

This instruction is effective only if the monitor mode flag is set in the program status register. If the 
monitor mode flag is cleared, this instruction becomes a pass instruction. When this instruction issues, 
it will execute the required channel functions without regard to the current status or activity at the 
output channel. 

The lowest order four bits of (Bk) are used in this instruction. The higher order bits are ignored. If 
higher order bits are set in (Bk), the lowest order four bits are masked out and used to determine the 
channel number. If (Bk) is zero, this instruction becomes a pass instruction. 

Normally, the output channel buffer is inactive when this instruction is executed, the program having 
checked for completion of the previous record before issuing an RO. The program can detect the end 
of record in two ways. First, it can compare the output channel buffer address with a known record 
length. The alternative is to obtain a response from the peripheral unit over the corresponding input 
channel data path. If data is moving over the output channel data path when an RO is issued, the RO 
instruction takes priority, with a resulting loss of data in the previous record. Two or more 
consecutive RO instructions referring to different channels will issue in consecutive clock periods with 
no interference resulting in the multiplexer. If two consecutive instructions refer to the same channel, 
they transmit a record pulse over the output path and restart the buffer repeatedly. A data word may 
or may not be transmitted depending on the timing of the instructions and conflicts that occur. 

Format: Functional Unit: None 


Operation 

Variable 

Description 

Size 

Octal Code 

RO 

Bk 

Reset output channel (Hs) buffer 

15 bits 

0170k 


Example: 


Code Generated 

0 17ns 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


)t 

18 

ho 




— 



po 

■IS : 
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8.4.12 READ CHANNEL STATUS INSTRUCTIONS (CYBER 70/MODEL 76 OR 7600) 

These instructions copy the contents of the input or output channel buffer address register indicated by 
masking (Hcq 3 _qq) and enter the value in Bj. The instructions are used for monitoring the progress of 
an input channel buffer or an output channel buffer. 

A channel buffer area is divided into fields by the threshold testing mechanism. The first half of the 
buffer area constitutes one field and the last half of the buffer area the other field. An I/O multiplexer 
interrupt request is generated by the threshold testing mechanism whenever the channel buffer address 
is advanced across a field boundary. This occurs at the center of the buffer area and at the end of the 
buffer area. 


The IBj instruction is the only vehicle for a program to determine whether an I/O multiplexer interrupt 
request was generated by a buffer threshold test or by a record flag. The program must retain the 
input channel buffer address from one interrupt period to the next. If the buffer address is in the same 
field as for the previous interrupt, the interrupt request was from a record flag. If the buffer address 
is in the opposite field from the previous interrupt, the interrupt request was from a threshold test. 

The lowest order four bits of (Bk) are used in these instructions. The higher order bits are ignored. 

If higher order bits are set in (Bk) the lowest order four bits are masked out and used to determine the 
channel number. If (Bk) = 0, the IBj instruction reads the contents of the CPU clock period counter. 
However, the OBJ Instruction places all zeros into Bj. 


Two or more IBj instructions or OBj instructions may occur in consecutive program instruction locations 
referencing the same or different channels. These instructions may issue in consecutive clock periods 
providing the Bj register reservations do not cause a delay. No interference will result in the multi¬ 
plexer in these situations. 

If correct results are to be obtained, an IBj instruction must not immediately follow an RI instruction 
nor may an OBj instruction immediately follow an RO instruction. A delay of one clock period is 
sufficient. 


Functional Unit: None 


Operation 

Variable 

Description 

Size 

Octal Code 

IBj 

Bk 

Bj —Read input channel (Bk) status 

15 bits 

016jk 

OBj 

Bk 

Bj—Read output channel (Hi) status 

15 bits 

017jk 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARlABie 

COMMENTS 


) 


n 


|30 




106 

04 

- 1 -_ 

1 

oirse ! 



085 

P6 

1 

1 
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8.4.13 UNCONDITIONAL JUMP INSTRUCTION 


This instruction adds the contents of index register Bi to K and branches to the relative CM (SCM) 
address specified by the sum. The remaining instructions, if any, in the current instruction word are 
not executed. The branch address is K when i is zero. 

Addition is performed in an 18-bit one's complement mode. On a CYBER 70/Model 72, 73, or 74 or 60C0- 
-Series system this instruction voids the stack. On a CYBER 70/Model 76 or 7600, the instruction word 
stack is not altered by execution of this instruction. The instruction is intended to allow computed branch 
point destinations. It is the only CPU instruction in which a computed parameter can specify a program 
branch destination address. All other jump instructions have preassigned destination addresses at 
execution time. 

The assembler sets the unused j designator to 0. A force upper occurs after the instruction is assembled. 


CYBER 70/Model 74 or 6600/6700 Functional Unit: Branch 
Format CYBER 70/Model 76 or 7600 Functional Unit: None 


Operation 

Variable 

Description 

Size 

Octal Code 

JP 

Bi+K 

Jump to (Bi)_+K 

30 bits 

02UK 

JP 

Bi 

Jump to (Bi) 

30 bits 

02ii0 00000 

JP 

K 

Jump to K 

30 bits 

0200K 


Example: 

Code Generated 


0?5500';?47 + 

02770oonon 



lOCATION 

0««ATION 

VAIIAIIE 

COMMENTS 

1 


II 

11 

ho 







JP 

B5+G0T0 

-1 - 

1 



JP 

n7 

1 

1 


8.4.14 X-REGISTER CONDITIONAL BRANCH INSTRUCTIONS 

These instructions cause the program sequence to branch to K or to continue with the current program 
sequence depending on the contents of operand register XJ. The decision is not made until the Xj 
register is free. These instructions do not void the stack. 

The following mles apply to tests made in this Instruction group: 

1. The ZR and NZ operations test the full 60-bit word in Xj. The words 00.00 and 77.77 

are treated as zero. All other words are non-zero. Thus, these instructions are not a valid 
test for floating point zero coefficients. However, they can be used to test for underflow of 
floating point quantities. 

59 

2. The PL and NG operations examine only the sign bit (2 ) of Xj, If the sign bit is zero, the 

word is positive; if the sign bit is one, the word is negative. Thus, the sign test is valid for 
fixed point words or for coefficients in floating point words. 


60360900 D 


8-23 





3. The IR and OR operations examine the upper-order 12 bits of Xj. 

On the 7600, the following quantities are detected as being out of range: 

3777x .X (positive overflow) 

4000x .X (negative overflow) 

1777x. ... .X (positive indefinite) 

6000x.X (negative indefinite) 

All other words are in range. An underflow quantity is considered in range. The value of the 
coefficient is ignored in making this test. 

On a 6000-Series computer system, 3777x.. .x and 4000x.. .x are out of range; all other words 
are in range. 

4. The DF and ID operations examine the upper-order 12 bits of Xj. Both positive and 
negative indefinite forms are detected: 

1777x .X and 6000x.x are indefinite 

All other words are definite. The value of the coefficient is Ignored in making this test. 


CYBER 70/Model 74 or 6600/6700 Functional Unit: Branch 
Formats: CYBER 70/Model 76 or 7600 Functional Unit: None 


Operation 

Variable 

Description 

Size 

Octal Code 

ZR 

Xj,K 

Branch to K if (Xj) = 0 

30 bits 

030jK 

NZ 

Xj.K 

Branch to K if (Xj) / 0 

30 bits 

031jK 

PL 

Xj,K 

Branch to K if (Xj) positive 

30 bits 

032jK 

NG 

Xj,K 

Branch to K if (Xj) negative 

30 bits 

033jK 

MI 

Xj.K 

Branch to K if (Xj) negative 

30 bits 

033jK 

IR 

Xj,K 

Branch to K if (Xj) in range 

30 bits 

034jK 

OR 

Xj.K 

Branch to K if (Xj) out of range 

30 bits 

035jK 

DF 

Xj.K 

Branch to K if (Xj) definite 

30 bits 

036jK 

ID 

Xj.K 

Branch to K if (Xj) indefinite 

30 bits 

037jK 
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8.4.15 B-REGISTER CONDITIONAL BRANCH INSTRUCTIONS 


These instructions test an 18-bit word from register Bi against an 18-bit word from register Bj for the 
condition specified. They branch to address K on a successfiil test. Otherwise, the program sequence 
continues at the next instruction. The decision is not made until both B registers are free. For the 
tests against zero (all zeros), the assembler sets either the i or the j designator to 0 indicating BO, 

The following rules apply in the tests made by these instructions; 

1. Positive zero is recognized as unequal to negative zero, and 

2. Positive zero is recognized as greater than negative zero, and 

3. A positive number is recognized as greater than a negative number. 

The 06 and 07 instructions are intended for branching on an index threshold test. The tests are made in 
a 19-bit one's complement mode. The (Bi) and the (Bj) are sign extended one bit to prevent erroneous 
results caused by exceeding the modulus of the comparison device. The (Bj) is then subtracted from the 
(Bi). The branch decision is based on the sign bit in the 19-bit result. 

For these instructions, Bi and Bj must be specified in the order indicated below. 

These instructions do not void the stack. 


CYBER 70/Model 74 or 6600/6700 Functional Unit: Branch 
CYBER 70/Model 76 or 7600 Functional Unit: None 


Ofie ration 

Variable 

Description 

Size 

Octal Code 

ZR + 

K 

Branch to K 

30 bits 

0400K 

ZR 

Bi,K 

Branch to K if (Bi) = 0 

30 bits 

04i0K 

EQ + 

K 

Branch to K 

30 bits 

0400K 

EQ 

Bi,K 

Branch to K if (Bi) = 0 

30 bits 

04i0K 

EQ 

Bi,Bj,K 

Branch to K if (Bi) = (Bj) 

30 bits 

04ijK 

NE 

Bi,K 

Branch to K if (Bi) / 0 

30 bits 

OSiOK 

NE 

Bi, Bj, K 

Branch to K if (Bi) / (Bj) 

30 bits 

OSijK 

Inz 

Bi,K 

Branch to K if (Bi) / 0 

30 bits 

OSiOK 

PL 

Bi,K 

Branch to K if (Bi) > 0 

30 bits 

06i0K 

GE 

Bi,K 

Branch to K if (Bi) > 0 

30 bits 

06i0K 

GE 

Bi,Bj,K 

Branch to K if (Bi) > (Bj) 

30 bits 

06ijK 

LE 

Bj,Bt,K 

Branch to K if (Bj) < (Bi) 

30 bits 

06ijK 

LE 

Bj,K 

Branch to K if (Bj) < 0 

30 bits 

060jK 

NG 

Bi,K 

Branch to K if (Bi) < 0 

30 bits 

07i0K 

MI 

Bi,K 

Branch to K if (Bi) < 0 

30 bits 

07i0K 


t The assembler forces the position counter upper after assembling the instructions. 


8-26 


60360900A 



Forma s (cont'd): 


1 

1 Operation 

Variable 

Description 

Size 

Octal Code 

GT 

Bj,Bi,K 

Branch to K if (Bj) > (Bi) 

30 bits 

07ijK 

i GT 

Bj,K 

Branch to K if (Bj) >0 

30 bits 

070jK 

LT 

Bi,K 

Branch to K if (Bi) < 0 

30 bits 

07i0K 

LT 

Bi.Bj.K 

Branch to K if (Bi) < (Bj) 

30 bits 

07ijK 


Examples; 


Code Generated 


LOCATION 

-1 

OPERATION 

VAItlAllE COMMENTS 


1 


" 

18 Iso 





-j-- ” 

tS4ci.';uoir?r’?i 



7<< 

'^5,072-70 I 

04n5QQ';?2? 



fO 

1 

^0 »-‘0UAL I 

04i3n05??? ♦ 



FO 

1 

^5 JLIM- 1 

(14 lOQO';??'! ♦ 



FO 


O'; *■ 



NF 

ni ,''>5,M0TrT 1 

1 

05'; 00 ♦ 



M7 

;’5.,''M0T7? 1 

1 

GB-’0005??e 



5L 

H2,nDLUS 1 

0P'4'^a05??7 4- 



r.5 

34,'S5,r,rn | 




GF 

''■<5,5rno 1 

r(fi’'f'0n5231 ♦ 



LE 

r»6,P 7,1 -than I 

f:7':’00a523? + 



Mr, 

HMCf, 

* 

073^005233 + 



MT 

-33,PTLT(j 

0767005234 + 



GT 

07,P6,37GT j 

0705006235 ♦ 



GT 

55,P6GTn ' 

0712005236 + 



LT 

P1,"?,3LT5 1 
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8.4.16 TRANSMIT INSTRUCTION 


This instruction transfers the 60-bit word in operand register Xj to register Xi. It is essentially a 
copy instruction intended for moving data from X register to X register as quickly as possible. No 
logical function occurs. The assembler sets the k designator to the value specified for j. 


Format: 


CYBER 70/Model 74 or 6600/6700 Functional Unit: Boolean 
CYBER 70/Model 76 or 7600 Functional Unit: Boolean 


Operation 

Variable 

Description 

Size 

Octal Code 

BXi 

Xj 

Transmit (Xj) to Xi 

15 bits 

lOijj 


Example: 


Code Generated 


LOCATION 

OPtRATION 

VARIABLE 

COMMENTS 


I 


n 

18 

|30 

106?? 



PX6 

X? 1 


8.4.17 LOGICAL PRODUCT INSTRUCTION 

This instruction forms the logical product (AND function) of 60-bit words from operand registers Xj and 
Xl< and places the product in operand register Xi, Bits of register Xi are set to 1 when the corresponding 
bits of the Xj and Xk registers are 1 as in the following example: 


(Xj) - 0101 
(Xk) - 1100 
(Xi) - 0100 


Ihis instruction is intended for extracting portions of a 60-bit word during data processing. If the j and 
k designators have the same value, the instruction becomes a transmit instruction. 


CYBER 70/Model 74 or 6600/6700 FTinctional Unit: Boolean 
CYBER 70/Model 76 or 7600 Functional Unit: Boolean 


Operation 

Variable 

Description 

Size 

Octal Code 

BXi 

Xj*Xk 

Logical product of (Xj) and (Xk) to Xi 

15 bits 

llijk 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


n 

16 

|30 




PX6 

iX5*X3 1 
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8.4.13 LOGICAL SUM INSTRUCTION 


This instruction forms the ogical sum (inclusive OR) of 60-bit words from operand registers Xj and 
Xk and places the sum in operand register Xi. A bit of register Xi is set to 1 if the corresponding bit 
of the Xj or Xk register is a 1 as in the following example: 


i<j) 0101 
(<k) 1100 

(Xi) = 1101 


iTiis instruction is intended for merging portions of a 60-bit word into a composite word during data 
processing. If the j and k designators have the same value, the instruction degenerates into a transmit 
instruction. 


CYBER 70/Model 74 or 6600/6700 Functional Unit: Boolean 
Formit; CYBER 70/Model 76 or 7600 Functional Unit: Boolean 


•jpserE 

Variable 

Description 

Size 

Octal Code 

BXi 

Xj+Xk 

Logical sum of (Xj) and (Xk) to Xi 

15 bits 

12ijk 


Exam jle: 

C )de Generated 

1271^7 



LOCATION 

OPERATION 

variable 

COMMENTS 

J 


n 

IB 

ho 







pxr 

xfe+y? : 


8.4.LOGICAL DIFFERENCE INSTRUCTION 


This instruction forms the logical difference (exclusive OR) of 60-bit words from operand registers 
Xj and Xk and places the difference in operand register Xi, A bit in register Xi is set to 1 if the 
corresponding bits in the Xj and Xk registers are unlike as in the following example: 

(Xj) - 0101 
iXk) - 1100 
(Xi) - 1001 


This instruction is intended for comparing bit patterns or for complementing bit patterns during data 
processing. If the j and k designators have the same value the result will be a word of all zeros written 
into register Xi. 


Format: 


CYBER 70Alodel 74 or 6600/6700 Functional Unit: Boolean 
CYBER 70/Model 76 or 7600 Functional Unit: Boolean 


Operation 

Variable 

— 

Description 

Size 

Octal Code 

BXi 

Xj-Xk 

Logical difference of (Xj) and (Xk) to Xi 

15 bits 

13ijk 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


n 

18 

ho 






13*^'’1 



PX6 

XO-Xl 1 
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8.4.20 COMPLEMENT INSTRUCTION 


Thiti instruction extracts the 60-bit word from operand register Xk, complements it, and transmits this 
complemented quantity to operand register Xi. It is intended for changing the sign of a fixed point or 
floating point quantity as quickly as possible. 


ihe assembler sets the unused j designator of the instruction to k. 

CYBER 70/Model 74 or 6600/6700 Functional Unit: Boolean 
CYBER 70/Model 76 or 7600 Functional Unit: Boolean 


Operation 

Variable 

Description 

Size 

Octal Code 

BXi 

-Xk 

Transmit complement of (Xk) to Xi 

15 bits 

14ikk 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


II 

18 

|30 

1U311 

i 


0X3 

Fxi-1- 


8.4.21 LOGICAL PRODUCT AND COMPLEMENT INSTRUCTION 

This instruction forms the logical product (AND function) of the 60-bit quantity from operand register 
Xj and the complement of the 60-bit quantity from operand register Xk, and places the result in operand 
register Xi, Thus, bits of Xi are set to 1 when the corresponding bits of the Xj register and the comple¬ 
ment of the Xk register are 1 as in the following example: 

(Xj) = 0101 

Complemented (Xk) = 0011 

(Xi) = 0001 

This instruction is intended for extracting portions of a 60-bit word during data processing. If the j and 
k designators have the same value, a logical product is formed between two complementary quantities. 
The result will be a word of all zeros. 


CYBER 70/Model 74 or 6600/6700 Functional Unit: Boolean 
CYBER 70/Model 76 or 7600 Functional Unit: Boolean 


Operation 

Variable 

Description 

Size 

Octal Code 

BXi 

-Xk*Xj 

Logical product of (Xj) and complement 
of (Xk) to Xi 

15 bits 

15ijk 


Examples: 


Code Generated 


LOCATION 

OPERATION , 

VARIABLE 

COMMENTS 


I 


II 

18 

1 30 

15432 



0X4 

-XP-’Xl 1 
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8.4.2‘ COMPLEMENT AND LOGICAL SUM INSTRUCTION 


This instruction forms the Icgical sum (inclusive OR) of the 60-bit quantity from operand register 
Xj and the complement of the 60-bit word from operand register Xk, and places the result in operand 
register Xi. Thus, bits of Xi are set to 1 if the corresponding bit of the Xj register is one or the 
corresoonding bits of the Xk register is a 0 as in the following example: 


(Xi) = 0101 
(X;) - 1100 t::. \ 

(X.) = 0111 

This instruction is intended for merging portions of a 60-bit word into a composite word during data 
processing. If the j and k designators have the same value the result is a word of all ones. 


CYBER 70/Model 74 or 6600/6700 Functional Unit: Boolean 
CYBER 70/Model 76 or 7600 Functional Unit: Botlean 


Operation 

Variable 

Description 

Size 

Octal Cc.de 

BXi 

-Xk+Xj 

Logical sum of (Xj) and complement of 
(Xk) to Xi 

15 bits 

16ijk 


Exarripi 3 ; 


Cede Generated 


LOCATION 

OPfKATlON . 

VAItlASlE 

COMMENTS 


I 


n 

18 

1 30 

16654 



PX6 

-XU+XP , 


8.4.23 COMPLEMENT AND LOGICAL DIFFERENCE INSTRUCTION 

This instruction forms the logical difference (exclusive OR) of the quantity from operand register Xj 
and the complement of the 60-bit word from operand register XT<, and places the result in operand 
register Xi. Thus, bits of Xi are set to i if the corresponding bits of Xj and register Xk are alikf as 
in the following example: 

(Xj) = 0101 
(Xk) = 1100 
(Xi) = 0110 

ihis instruction is intended for comparing bit patterns or for complementing bit pritterns during data 
processing. If the j and k designators have the same value, a logical difference is formed between two 
complementary quantities. The result is a word of all ones. 


CYBER 70/Model 74 or 6600/6700 Functional Unit: Boolean 
CYBER 70/Model 76 or 7600 Functional Unit: Boolean 


(Iteration 

Variable 

Description 

Size 

Octal Code 

BXi 

-Xk-Xj 

Logical difference of (Xj) and complement 
of (Xk) to Xi 

15 bits 

17ijk 


60360900A 


8-31 



Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 



1 


11 

18 

|30 


17731 



RX7 

X 

1 

X 

1 


8.4.24 LOGICAL LEFT SHIFT jk PLACES INSTRUCTION 

This instruction shifts the 60-bit word in operand register Xi left circular jk places if expression jk is 
positive or left circular 60+jk places if jk is negative. Bits shifted off the left end of operand register 
Xi replace those shifted from the right end. 

The 6-bit shift count jk allows a complete circular shift of (Xi). 

In COMPASS notation, Jk is an absolute expression. If it is positive, COMPASS places the lower 6 
bits on the value in the jk fields. If it is negative, COMPASS adds 60 to jk and places the result 
in the jk fields. Thus, a negative value effectively designates a logical right shift. A positive value 
designates a left shift. 

If the negative shift count is less than -60, the assembler generates a 7-type error. 


CYBER 70/Model 74 or 6600/6700 Functional Unit: Shift 
CYBER 70/Model 76 or 7600 Functional Unit: Shift 


Operation 

Variable 

Description 

Size 

Octal Code 

LXi 

jk 

Logical shift (Xi) by + jk places 

“ — 1 ..—— ^——... 1 . , 

15 bits 

20ijk 


Example; 


Code Generated 


lOCATION 

OPERATION 

variable 

COMMENTS 


I 


n 

IB 

Uo 





|lx3 

?5R 

- 1- - 

1 


•> 



1 

-12P 

1 

1 



I 


8.4.25 ARITHMETIC RIGHT SHIFT jk PLACES INSTRUCTION 

This instruction shifts the 60-bit word in operand register Xi right jk places if expression jk is positive 
and right 60+jk places if expression jk is negative. The rightmost bits of Xi are discarded and the sign 
bit is extended. 

If the shift count is equal to the 60-bit register length, the result contains 60 copies of the sign bit. If 
the operand is positive, a positive zero results. If the operand is negative, a negative zero results. 

In COMPASS notation, jk is an absolute expression. If it is positive, COMPASS places the lower rt 
bits of the value in the jk fields. If it is negative, COMPASS adds 60 to jk and places the result 
in the jk fields. Thus, a negative value effectively designates the number of high order bits of 
the operand that are to be retained. If the negative shift count is less than -60, a 7-type error is 


8-32 


60360000(’ 



Format: 


CYBER 70/Model 74 or 6600/6700 Functional Unit: Shift 
CYBER 70/Model 76 or 7600 Functloial Unit: Shift 


Operation 

Variable 

Descrip tioii 

Size 

Octal Code 

AXi 

jk 

Arithmetic shift (XI) by + jk places 

15 bits 

21ijk 


Example: 


Code Generated 


LOCATION 

OPKATION 

VARIAILE 

COMMENTS 



1 


II 

II 

|30 





flxs 

77 n j 


8.4 26 LOGICAL LEFT SHIFT (Bj) PLACES INSTRUCTION 

This Instruction shifts the 60-bit quantity from operand register Xk the number of places specified by 
the quantity in index register Bj and places the result in operand register XI. 

1. If (Bj) is positive, (that is, bit 17 of BJ = 0), the quantity from Xk is shifted left circular. The 
low order 6 bits of (Bj) specify the shift count. The higher order bits are ignored. 

2. If (Bj) is negative, (that is, bit 17 of Bj = 1), the quantity from Xk is shifted right (end off with 
sign extension). The one's complement of the low order 12 bits of (Bj) specify shift count. 

The higher order bits are Ignored. If the shift count is greater than 60 (decimal) the result 
stored in the XI register consists of 60 copies of the operand sign bit. 

If - Bj is specified, the assembler converts the instruction to an arithmetic right shift. The (Bj) might 
be the result of an unpack instruction, in which case it is the unbiased exponent and (Xi) is the coefficient 
This instruction is used for shifting a coefficient from a floating point number to the integer position 
..fter an ;mpack operation. 

CYBER 70/Model 74 or 6600/6700 Functional Unit: vShift 
Format: CYBER 70/Model 76 or 7600 Functional Unit: Siiift 


Operation 

Variable 

Description 

Size 

Octal Code 

LXl 

Xk, Bj 

Logically shift (Xk) by (Bj) places to Xi 

15 bits 

22ijk 

LXl 

Bj,Xk 

Logically shift (Xk) by (Bj) places to Xi 

15 bits 

22ijk 

LXl 

Xk 

Transmit (Xk) to Xi 

15 bits 

22i0k 

l-Xi 

Bj 

Logically shift (Xi) by (Bj) places to XI 

15 bits 

22iji 

LXi 

-Bj,Xk 

Arithmetic right shift (Xk) by (Bj) 
places to Xi 

15 bits 

23ijk 

LXi 

Xk,-Bj 

Arithmetic right shift (Xk) by (Bj) 
places to Xi 

15 bits 

23ijk 

LXi 

-Bj 

Arithmetic right shift (Xi) by (Bj) 
places to Xi 

15 bits 

23iji 

1 


60360900 D 


8-33 













Example: 


Code Generated 


LOCATION 

OrEDATION 

VAtlASU 

COMMENTS 



1, 


II 

\b 

ho 


??f>75 



LX6 

x>;,n7 

-f—-- 

1 


2?5-'4 



LX5 

S7,X4 

1 

1 


22302 



LX3 

X2 

i 

1 



8.4.27 ARITHMETIC RIGHT SHIFT (Bj) PLACES INSTRUCTION 

This Instruction shifts the 60-bIt quantity from operand register Xk the number of places specified 
by the quantity in index register BJ and places the result in operand register Xi. 

1. If (Bj) is positive (that is, bit 17 of Bj = 0), the quantity from register Xk is shifted right (end 
off with sign extension). The lower 12 bits of (Bj) specify the shift count. The higher order 
bits are ignored. For the CYBER 70/Model 72, 73, 74 and 6000-Series Computer Systems, 

if the shift count is 64 (decimal) or more, the XI register Is zeroed. For the CYBER 70/Model 
76 or 7600 Computer ^sterns, if the shift count is 64 (decimal) or more the Xi register con¬ 
tains 60 copies of the sign of the operand. 

2. If (Bj) is negative (that is, bit 17 of Bj = 1), the quantity from register Xk is shifted left 
circular. The complement of the lower order 6 bits of Bj specify the shift count. The higher 
order bits are ignored. 

If -B Is specified, the assembler converts the instruction to a logical left shift. This instruction is in¬ 
tended for use in data processing where the amount of shift Is derived in the computation. This in¬ 
struction is also useful for adjusting the coefficient of a floating point number while it is in Its unpacked 
form. 


CYBER 70/ModeI 74 or 6600/6700 Functional Unit; Shift 
CYBER 70/Model 76 or 7600 Functional Unit: Shift 


Operation 

Variable 

Description 

Size 

Octal Ccxie 

AXl 

Xk,Bj 

Arithmetic shift of (Xk) by (Bj) places 
to Xi 

15 bits 

1 

23ijk 

AXl 

Bj,Xk 

Arithmetic shift of (Xk) by (Bj) places 
to Xi 

15 bits 

23ijk 

AXi 

Xk 

Transmit (Xk) to Xi 

15 bits 

23i0k 

AXi 

Bj 

Arithmetic shift of (Xi) by (Bj) places 
to Xi 

15 bits 

23iji j 

AXi 

-Bj,Xk 

Logically shift (Xk) by (Bj) places to Xi 

15 bits 

22ijk 

AXl 

Xk,-Bj 

Logically shift (Xk) by (Bj) places to Xi 

15 bits 

22ijk 

AXi 

-Bj 

Logically shift (Xi) by (Bj) places to Xi 

15 bits 

22iji 


8-34 


60360300 i 



Examp' 3: 

Code Generated 


23 ?11 
23502 
23!*24 



LOCATION 

OfEtATtON 

VARIABLE 

COMMENTS 

1 


II 

18 

ho 




—-_ .. . ...— ____ 



ftX7 

X4,n6 

1 

1 



AX2 

R1,X1 

1 

1 



AX'; 

X2 

1 



ftX4 

B2 

1 


8.4.28 NORMALIZE INSTRUCTION 


This instruction normalizes the floating point quantity from operand register Xk and places it in 
operam register Xi. Normalizing consists of shifting the coefficient the minimum number of position.? 
required to make bit 47 different from bit 59. This places the most significant bit of the coefficient 
ia the I .ighest order position of the et>3fficient portion of the word. The exponent portion of the v^ .rd 
is then decreased by the number of bit positions shifted. The number of shifts required to normalize 
the quantity is entered in index register Bj. 


60360900B 


8-34. 1 



Fo’ mat: CYBER 70/Model 74 or 6600/6700 Functional Unit: Shift 

CYBER 70/Model 76 or 7600 Functional Unit: Shift 


Operation 

Variable 

Description 

Size 

Octal Code 

N>“ 

Xk 

Normalize (Xk) to Xi 

15 bits 

24i0k 

NX' 

Bj,Xk 

Normalize (Xk) to Xi; shift count to Bj 

15 bits 

24ijk 

NX 

Xk, Bj 

Normalize (Xk) to Xi; shift coimt to Bj 

15 bits 

24ijk 

NX 


Normalize (Xi) to Xi 

15 bits 

24i0i 

NX. 

Bj 

Normalize (Xi) to Xi; shift count to Bj 

15 bits 

24iji 


Example; 


Code Generated 


LOCATION 

OMRATION 

VARIABLE 

COMMENTS 




1 


n 

)8 

[30 






MX*: 

X5,97 

-1-.... 

1 






NIX'; 


1 

1 



- ? 




X2 

1 




8.4.2/ ROUND AND NORMALIZE INSTRUCTION 

This > istiiiction performs the same operation as the NXi instruction with the exception that the (quantity 
from operand register Xk is rounded before it is normalized. Rounding is accomplished by placing a 
1 round bit immediately to the right of the least significant coefficient bit. The resulting coefficient is 
increased by one-half the value of the least significant bit. Normalizing a zero coefficient places the 
round bit in bit 47 and reduces the exponent by 48. Note that the same rules apply for underflow, overflow, 
infinite, and indefinite results. 


If (Xk) is an infinite quantity (3777x... x or 4000x... x) or an indefinite quantiiy (1777x... x or 60/0x. .. x). 
no shiT takes place. The contents of Xk are copied into Xi, and Bj is set to zero. 


CYBER 70/Model 74 or 6600/6700 Functional Unit: Shift 
Formats: CYBER 70/ModeI 76 or 7600 Functiraial Unit: Shift 


Operation 

Variable 

Description 

Size 

Octal Code 

Z.Xi 

Xk, 

Round and normalize 

(Xk) to -Xi 

15 bits 

25i0k 

'1,'Ai 

BJ,Xk 

Round and normalize 
count to Bj 

(Xk) to Xi, .shifi. 

15 bits 

25ijk 

ZXi 

Xk, Bj 

Round and normalize 
count to Bj 

(Xk) to Xi; shift 

15 bits 

25ijk 

ZXi 

Bj 

Round and normalize 
count to Bj 

(Xi) to Xi; shift 

15 bits 

25iji 

ZXi 


Round and normalize 

(Xi) to Xi 

15 bits 

25i0i 1 


60360900A 


8-35 



Kxample: 


Code Generated 

254'’4 




1— 


_ 

LOCATION 

OPf RATION 

VARIABLE COMMENTS 

) 


M 

18 llO 



7X4 

X4,P7 1 



7X4 

1 

1 



ZX7,fl6 

XI 1 


8.4.30 UNPACK INSTRUCTION 


ITus instruction unpacks the floating point quantity from operand register Xk and sends the 48-bit 
coefficient to operand register Xi and the 11-bit exponent to index register Bj. The exponent packing 
IS removed during unpack so that the quantity in Bj is the true one's complement representation of the 
exponent. The contents of Xk need not be normalized. 


The exponent and coefficient are sent to the low-order bits of the respective registers as shown below: 



Special operand formats are treated in the same manner as normal operands. 


CYBER 70/Model 74 or 6600/6700 Functional Unit: Shift 

CYBER 70/Modet 76 or 7600 Functional Unit: Boolean 


Operation 

Variable 

Description 

Size 

. “1 

Octal Code j 

UXi 

Xk 

Unpack (Xk)to Xi 

15 bits 

2oi0k 1 

1 :Xi 

Bj.Xk 

Unpack (Xk) to Xi and Bj 

15 bits 

26ijk 

UXi 

Xlc, Bj 

Unpack (Xk) to Xi and Bj 

15 bits 

26ijk 

UXi 


Unpack (Xi) to Xi 

15 bits 

26i0i 

UXi 

Bj 

Unpack (Xi) to Xi and Bj 

15 bits 

26iji 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABIE comments 

1 


n 

18 iso 

CO f f f 



"UX7 

X7,97 1 ■■ - - - ■ 

26342 



UX3,X2 

CD 

26707 



UX7 

i 1 

1 

26777 



UX7 

1 

87 i 


n-36 


60S60900A 




8.4.31 PACK INSTRUCTION 


This instruction packs a flo ting point number in operand register Xi. The coefficient of the number is 
obtained from operand register Xk and the exponent is obtained from index register Bj. The exponent is 
packed by toggling bit 2^® during the pack operation. The instruction does not normalize the coefficient. 

Expoi ent and coefficient are obtained from the proper low-order bits of the respective registers aad 
packed in reverse order as shown in the illustration for the unpack instruction. Thus, bits 58-48 oi 
Xk ane bits 17-11 of Bj are ignored. There is no test for overflow or underflow. No flags are set in the 
PSD r 3gister by this instruction. 

Note that if pfk) is positive, the packed exponent occupying Xi 5 g_ 4 g is obtained from BJio-OO by 
complementing bit 10; if pck) is negative, bit 10 is not complemented but bits 09-00 are complemented. 

The J designator may be set to zero in this instruction to pack a fixed point integer into floating point 
forma i without using one of the active B registers (exponent = 0). 


CYBER 70/Model 74 or 6600/6700 Functional Unit: Shiit 
Format: CYBER 70/Model 76 or 7600 Pdmctional Unit- Boolean 


Operjtlou 

Variable 

Description 

Size 

Octal Cfjde 

PXi 

Xk 

Pack (Xk) to Xi 

15 bits 

27i0k 

PXi 

Xk, Bj 

Pack (Xk) and (Bj) to Xi 

15 bits 

27ijk 

PXi 

Bj, Xk 

Pack (Xk) and (Bj) to Xi 

15 bits 

27ljk 

PXI 

Pack (Xi) to Xi 

15 bits 

27i0i 

PXI 

Bj 

_1 

Pack (Xi) and (Bj) to Xi 

15 bits 

27iji 


Example: 


Code Generated 


LOCATION 

OntATION 

VAKIABIE COMMENTS 


s 


)! 

18 139 

1*7565 



PX5 

X5,56 1 

2 7S71 



PX6,P7 

1 

XI 1 

27505 



PX5 

i 

t 7S 65 



PX5 

35 1 

t 


8.4.32 UNROUNDED SP FLOATING POINT ADD INSTRUCTIONS 

i'ite'se iustrucdioiis form the unrounded suni cr difference of the fioatiofe poir„; quantities from oj.jerarid 

registers Xj and Xk and pack the result in operand register Xi. The packed result is the upper half of 
a double precision sum or difference. 

At the start both arguments are unpacked, and the coefficient of the argument with the smaller exponent 
R ' ir -cd into the upper half of the accumulator. The coefficient is shifted right by the difference 
of the exponents. The other coefficient is then added to or subtracted from the upper half of the 
accumulator. If overflow occurs, the result is right-shifted one place and the exponent of the result 
increased by one. The upper half of the accumulator holds the coefficient of the result, which is not 
necessarily in normalized form. The exponent and upper coefficient are then repacked in operand 
register Xi. 


60360900A 


8-37 


KormatH: CYBER 70/Model 74 or 0600/6700 Functional Unit: Floating Add 

CYBER 70/Model 76 or 7600 Functional Unit: Floating Add 


Operation 

Variable 

Description 

Size 

Octal Code 

FXi 

Xj+Xk 

Floating point sum of (Xj) and (Xk) to Xi 

15 bits 

30ijk 

FXi 

Xj-Xk 

Floating point difference of (Xj) minus 
(Xk) to Xi 

15 bits 

31ijk 


Examples: 


Code Generated 


LOCATION 

OPERATION 

VAHIABIE COMMENTS 

30T45 

31213 

1 


n 

18 130 



FX3 

FX2 

XU+XF ^ 

1 

Xl-X? 


8.4.33 DP FLOATING POINT ADD INSTRUCTIONS 


These instructions form the sum or difference of two floating point numbers as in the single precision 
in.structions, but pack the lower half of the double precision result with an exponent 48 less than the 
upper sum. The result is not necessarily normalized, 

CYBER 70/Model 74 or 6600/6700 Functional Unit; Floating Add 
formats: CYBER 70/Model 76 or 7600 Functional Unit: Floating Add 


Operation 

Variable 

Description 

Size 

Octal Code 

DXi 

Xj+Xk 

Floating DP sum of (Xj) and (Xk) to Xi 

15 bits 

32ijk 

DXi 

Xj-Xk 

Floating DP difference of (Xj) and (Xk) 
to Xi 

15 bits 

33ijk 

... . . .. 


Examples: 


Code Generated 

1- 

i . 

LOCATION 

OPERATION 

VARIABLE 

COMMENTS 



0 


It 

IB 

Uo 


323?3 



0X3 

X2tX3 

—-4 — 

1 


3341«* 


i 

nx4 

XI -y4 

I 

1 



■•■i-38 


60360900.4 










8.4.34 ROUNDED SP FLOATING POINT ADD INSTRUCTIONS 


These nstructions form the 'ounded sum or difference of the floating point quantities from operand 
registers Xj and Xk and pack the upper portion of the double precision result in operand register Xi. 
These instructions are intended for use in floating point calculations involving single precision 
accuracy. 


CYBER 70/Model 74 or 6600/6700 Functional Unit: Floating Add 
CYBER 70/Model 76 or 7600 Functional Unit: Floating Add 


Operation 

Variable 

Description 

Size 

Octal Code 

RXi 

Xj+Xk 

Rounded floating sum of (Xj) and (Xk) 
to Xi 

15 bits 

34ijk 

RXi 

... 

Xj-Xk 

Rounded floating difference of (Xj) minus 
(Xk) to Xi 

15 bits 

35ijk 


Examples: 


Code Generated 

1 


LOCATION 

OPeiATION 

VARlABiC 

COMMENTS 



i 

. .j 

II 

18 

bo 


34514 



PX5 

X1 + X4 

-1- 

f 


35651 



RX6 

X5-X3 

1 

1 



8.4.35 LONG ADD (FIXED POINT) INSTRUCTIONS 

'These instructions form the 60-bit onels complement integer sum or integer difference of quantities from 
operand registers Xj and Xk and store the result in operand register Xi. An overflow condition is 
ignored. 


Tlie insiniidioas are intended for addition or subtraction of integers too iarge for handling in the 
increment unit. They are also useful for merging and comparing data fields during data processing. 

For an addition^ if both operands are zero, the result is zero, ff either zero operand is positive zero 
(all O's), the result is a positive zero quantity. If both operands are minus zero (all I's), the result 
is a negative zero quantity. 


60360900A 


8-39 







Format: 


CYBER 70Alodel 74 or 6600/6700 Functional Unit; I.oiig Add 
CYBER 70/Model 76 or 7600 Functional Unit; Long Add 


Operation 

Variable 

Description 

Size 

Octal Code 

IXi 

Xj+Xk 

Integer sum of (Xj) and (Xk) to Xi 

1.5 bits 

36ijk 

IXi 

Xj-Xk 

Integer difference of (Xj) minus (Xk) 
to Xi 

15 bits 

37ijk 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE COMMENTS 


I 


n 

18 Uo 



1X5 

1X6 

-1-- 

X4+X5 1 

1 

X3-X1 1 


8.4.36 UNROUNDED SP FLOATING POINT MULTIPLY INSTRUCTION 

This instruction multiplies two floating point quantities obtained from operand registers Xj (multiplier) 
and Xk (multiplicand) and packs the upper product result in operand register Xi. 

In this operation, the exponents of the two operands are unpacked from the floating point format and are 
added with a correction factor of 48 to form the exponent for the result. The coefficients are multiplied 
as signed integers to form a 96-bit integer product. The upper half of this product is then extracted 
to form the coefficient of the result. The result is a normalized quantity only when both operands are 
normalized; the exponent in this case is the sum of the exponents plus 47 (or 48). The result is not 
normalized when either or both operands are not normalized. 


CYBER 70/Model 74 or 6600/6700 Functional Unit: Floating Multiply 
Formats: CYBER 70/Model 76 or 7600 Functional Unit: Floating Multiply 


Operation 

Variable 

Description 

Size 

Octal Code 

rai 

Xj*Xk 

Floating point product of (Xj) and 
(Xk) to Xi 

15 bits 

40ijk 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 


COMMENTS 



I 


tl 

18 


ho 


40011 



FXO 

X1*X1 


-t— • 

1 

1 



8-40 


603 609 Oi' A 








8.4.37 ROUNDED SP FLOATING POINT MULTIPLY INSTRUCTION 


This instruction multiplies the floating point number from operand register Xk (multiplicand), by the 
floating point number from operand register Xj. The upper product result is packed in operand 
register Xi. (No lower product is available.) The multiply operation is identical to that of the single 
precision in.struction except that a rounding bit is added in bit position 46 of the 96-bit product. 1 te 
upper h .lf of the product is then extracted to form the coefficient for the result. An alternate outjAit 
path is provided with a left shift of one-bit position to normalize the result coefficient if the original 
operands were normalized and the double precision product has only 95 bits of significance. The 
exponent for the result is decremented by one count in this case. 

Format; CYBER TOAlodel 74 or 6600/6700 Functional Unit: Floating Multiply 


CYBER 70/M(^el 76 or 76 00 Functional Unit: Floating Multiply 


|opc ration 

Variable 

Description 

Size 

Octal Code 

RXi 

Xj*Xk 

Rounded floating point product of (Xj) 
and (Xk) to Xi 

15 bits 

41ijk 


Example: 


Code Generated 

n 

U 

lOCATIOvI 1 

0?£(tATiCN 

V/filABlE 

COMMENTS 




■ I 

n 

13 

! 30 

. . . 

41 


1 

i 9X2 

1 

x3»y? 1 

1 


8 4.38 DP FLOATING POINT MULTIPLY INSTRUCTION 

This instruction multiplies two floating point quantities obtained from operand registers Xj and Xk 
iuid packs the lower product in operand register Xi. The two 48-bit coefficients are multiplied together 
to form a 96-bit product. The lower-order 48 bits of this product (bits 47-00) are then packed together 
with the resulting exjjonent. The result is not necessarily normalized. Tne exponent of tnis resuit is 
48 less than the exponent resulting from an unrounded single precision instruction using the same 
opsriii'. drr. 

This instruction is intended for use in multiple precision floating point calculations. It may also be 
used to form the product of two integers providing the resulting product does not exceed 48 bits of 
significance. The operands must be packed in floating point format before executing this instruction. 
The results must be unpacked to obtain the integer product. 


CYBER 70/Model 74 or 6600/6700 Functional Unit: Floating Multiply 
Format: CYBER 70/Model 76 or 7600 Functional Unit: Floating Multiply 


Operation 

Variable 

• 

Description 

Size 

Octal Code 

DXi 

Xj-^Xk 

Floating point DP product of (Xj) and 
(Xk) to Xi 

15 bits 

42ijk 


8-41 



Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


I 


M 


ho 

42 345 



0X3 

n(4,X5 

1 


8.4.39 INTEGER MULTIPLY INSTRUCTION 

The CPU integer multiply instruction is, to COMPASS, synonymous with the double precision floatii^ 
point multiply instruction. Regardless of how it is written in COMPASS, the 42ijk instruction is 
executed as follows: If each operand register has all zeros or all ones in its leftmost 12 bits, the 
47-btt integer product is formed in Xi with sign extension in its leftmost 12 bits. (Exception: if each 
operand has bit 247 different from its sign bit, the result is shifted left one bit position.) Otherwise, 
a double precision floating point multiplication is performed. Thus, there is no need to pack exponents 
into the operands, and unpack the result, for an integer multiply. COMPASS provides the alternate 
symbolic representations IXi Xj+Xk and DXi Xj+Xk for the 42ijk instruction as an aid to program read¬ 
ability, so the programmer can indicate whether the instruction is being used for integer multiplication. 

Format: CYBER 70/Model 74 or 6600/6700 Functional Unit: Floating Multiply 

CYBER 70/Model 76 or 7600 Functional Unit: Floating Multiply 


Operation 

Variable 

Description 

Size 

Octal Codi 

IXi 

Xj*Xk 

Integer product of (Xj) and (Xk) to Xi 

15 bits 

42ijk 


Example: 


Cfxle Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 





1 


n 

18 

ho 




42234 



1X2 

1 

X3*X4 1 

1 


8-42 


60360900 J. 











8.4.4C MASK INSTRUCTION 


This instruction clears regis er Xi and forms a mask in it, A positive value for egression jk defines 
the number of I's in the mask as counted from the highest order bit in XI. A negative value for 
expreetion jk defines the number of 0 bits (unmasked) counted from the low order bit in Xi. The 
completed masking word consists of I's in the high order bit positions of the word and O's in the 

r amaii* icr of the word. 


The coi tents of operand register i are zero when jk is zero. The contents of operand register i are 
all one: when jk is 60. 

This in.itruction is intended for generated variable width masks for logical operations. Used with the 
shift inatrsK tioii, fids instruction creates an arbitrary field mask faster than by reading a pre-gei orated 
mask fiom storage. 


In CO?/PASS notation, 
■at,} Pa j’: f’ 


if the value of absolute expression jk is positive, the assembler inserts it 

s-,R8eE,ibled Jnst'raeiJoa. If Ihe ■r&lue of absolute expi'ssjs:ks,ii Jk is nagaitl.rej 


the ass ambler adds 60 to the expression value and places the sum in the jk field of the assembled 


instruction. 


A negat ve jk value less than “60 results in a 7~type assembly error. 


'VIA! d ia the fastest inatiuctioa for clearing im X register. 


Format 6600 Functional Unit: Shift 

7600 Functional Unit; Shift 


Operation 

Variable 

Description 

Size 

Octal Code 

MXi 

Jk 

Form mask in Xi, + jk bits 

15 bits 

43ijk 


Fxairjpii--. 

Cods Ge ner ated 

45042 

43Jv0 



60360900C 
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8.4.41 UNROUNDED SP FLOATING POINT DIVIDE INSTRUCTION 

\ 

This instruction divides twoTiormalized floating point quantities obtained from operand registers Xj 
(dividend) and Xk (divisor) and pack's the quotient in operand register Xi. 


CYBER 70/Model 74 or 6600/6700 Functional Unit: Floating Divide 
CYBER 70/Model 76 or 7600 Functional Unit: Floating Divide 


Operation 

Variable 

Description 

Size 

Octal Code 

FXi 

Xj/Xk 

Floating point divide of (Xj) by (Xk) 
to Xi 

15 bits 

44ijk 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 



I 


It 

18 

|30 


44671 



|fX6 

X3/X1 1 


8.4.42 ROUNDED SP FLOATING POINT DIVIDE INSTRUCTION 

This instixiction divides the floating quantity from operand register Xj (dividend) by the floating point 
quantity from operand register Xk (divisor) and packs the rounded quotient in operand register Xi. 

Format: CYBER 70/Model 74 or 6600/6700 Functional Unit: Floating Divide 

CYBER 70/Model 76 or 6700 Functional Unit: Floating Divide 


Operation 

Variable 

Description 

Size 

Octal Code 

RXi 

Xj/Xk 

Rounded floating point division of (Xj) 





by (Xk) to Xi 

15 bits 

45i]k 


Example: 


Code Generated 

4, <5724 


- 

LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


II 

18 

ho 




-- 



RX7 

X2/X4 1 
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8.4.43 PASS INSTRUCTION 


The no-operation (pass) insfa action is not associated with a functional unit. This instruction is a do- 
nothing instruction used typically to pad the program between steps. An integer value in the variable 
field (optional) is inserted into the lower 9 bits of the instruction. The assembler automatically pads 
the remainder of a word whenever a force upper occurs; in this case, the programmer is not required 
to inse t the NO. 


CYBER 70/Model 74 or 6600/6700 Functional Unit: None 
CYBER 70/Model 76 or 7600 Functional Unit; None 


Operation 

Variable 

Description 

- 1 

Size 

Octal Code 

NO 


Pass 

15 bits 

46000 

NO 

n 

Pass 

15 bits 

_ 

46n 


Code Generated 


LOCATION 

OPfftATlON 1 

VARIABLE 

COMMENTS 



1 

... 

- -J 

18 

Ijo 


4 if 0 0 C 

I 1 


NO i 

1 I 


8.4.44 POPULATION COUNT INSTRUCTION 

This inatruction counts the number of 1 bits in operand register Xk and stores the count in the lower 
order 6 bits of operand register Xi. Bits 59-06 are cleared. 

If Xk is a word of all ones, a count of 60 (decimal) is delivered to the Xi register. If Xk is a word of all 
zeroes, a zero word is delivered to the Xi register. 


The as f ern bier sots the unused j designator to k. 

Formal CYBER 7G/Modei 74 or 6600/6700 Functional Unit: Floating D vide 

CiBER 70/Modei 76 or 7600 Functional Unit; Population Count 


Operation 

Variable 

Description 

Size 

Octal Code 

1 

CXi 

Xk 

Count of number of I's in (Xk) to Xi 

_ 

15 bits 

47ikk 


Example: 

Code Generated 

477m 



LOCATION 

OPERATION 

COMmEHiS 

I 


II 

<8 ho 



rx7 

xo ! 


603609OOA 
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8.4.45 SET A REGISTER INSTRUCTIONS 


These instructions are intended for fetching operands from storage for computation and for delivering 
results back into storage. The instructions have two destination registers; the Ai register which 
receives the address formed from the operands and either the Xi register or a CM (SCM) storage location. 

If the i designator is nonzero, a storage reference is made using the lower 15, 16, or 17 bits of the 
resulting sum or difference as the relative storage address depending on machine size. The upper 
bits are ignored. The type of storage reference is a function of the i designator value. 

i 0; no storage reference 

i = 1, 2, 3, 4, or 5; contents of CM (SCM) relative address (Ai) to register Xi 
i = 6 or 7; contents of register Xi stored at CM (SCM) relative address (Ai) 


Formats: 

Operation 


CYBER 70/Model 74 or 6600/6700 
CYBER 70/Model 76 or 7600 


Functional Unit: Increment 
Functional Unit: Increment 


Variable 


Description 



Examp* 3s: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


It 

18 

Iso 






sonoooeoi 



‘^Al 

AU 4-1 

1- 

1 

51Cn?77774 



5A0 

- 7 

1 

'5i?ioaonQ3 



5A2 

3+ PI 

1 

1 

5?3 1777771 



SA3 

1 

X 

1 

1 

'53411 



5A4 

xi+ni 

1 

S U 5 ^1. 



5A5 

ft4f PI 

1 

1 

^ ^ G •* 1 



'^A5 

a4 + f’l 


54540 



5A5 

A4 

1 

5'5^41 



5A6 

-PI 4A4 

1 

1 

5f>?ll 



5A7 

Pl + Pl 

1 

5 75' ■’1 



5A7 

3?-ri 

1 

1 
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8.4,46 SET B REGISTER INSTRUCTIONS 


These instructions perform one's complement addition and subtraction of 18-bit operands and store an 
18~bit result in index register Bi. 

Operands are obtained from address (A), index (B), and operand (X) registers as well as from the 
instruction itself (K == 18-bit operand). Operands obtained from an XJ operand register are the 
truncated lower 18 bits of the 60-bit word. The highest order bits are ignored; an overflow condition 
is also ignored. 


If the i designator is a zero, the instruction is a do-nothing instruction. 

CYBER 70/Model 74 or 6600/6700 Functional Unit: Increment 
Formats: CYBER 70/Model 76 or 7600 Functional Unit: Increment 


lOpe ration 


Variable 


Description 









Examps 3s: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 

— 


16 

ho 

bOl1 77777 ? 




ai-5 

-1-- 

1 

6 1 1 07777 7 ? 





( 

1 

b 1 s 1 n 0 0 G 11 



CO’ 

3 + nn-b 

1 

1 

b?710Q010n 




xi+innn 

1 

1 




cni. 

X?4-07 

1 

1 

b4-;4i 





1 

1 

77- ■■ s. ' 



cnb 


1 





-01+84 

1 

1 

b'-IbU? 




a4-P7 

1 

! 

b6?ll 



<tR7 

tu + '^l 

1 

1 

K ? 



?8 7 

pe;-ni 

1 

! 


3.4 4r SET K REGISTER INSTRUCTIONS 

The SXi instructions perform one's complement addition and subtraction of 18-bit operands and store 
an 18-bit result into the lower 18 bits of operand register Xi. The sign of the result is extended to the 
upper 42 bits of operand register Xi. An overflow condition is ignored. 

■>per?s;iis are obtained from address (A), index <;B), and operand (X) registers as well as the instructior 
iiseli {K - 13--bit ..iperand). Operands olnamerl from an Xj register arc the truncated lower 18 bits oftho 
GO-bit word The highest order bitr c rc igot red 


60360S00A 
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Formats: 


CYBER 70/Model 74 or 6600/6700 Functional 
CYBER 70/Model 76 or 7600 Functional 


Unit: Increment 
Unit: Increment 


Variable 


Examples: 

Code Generated 

700000'=;233 + 

71107757'5'; 

7i?inot]nn‘5 

7?3^77774t. 

73«*42 

74S=;3 

74540 
75641 
75604 
76776 
77751 


Description 


Set Xi to 

(Aj) 

+ K 

Set Xi to 

K 


Set Xi to 

(Bi) 

+ K 

Set Xi to 

Pfj) 

+ K 

Set Xi to 

(Xj) 


Set Xi to 

(Xj) 

+ (Bk) 

Set Xi to 

(Xj) 

+ (Bk) 

Set Xi to 

(Aj) 


Set Xi to 

(Aj) 

+ (Bk) 

Set Xi to 

(Aj) 

+ (Bk) 

Set Xi to 

(Aj) 

- (Bk) 

Set Xi to 

(Aj) 

- (Bk) 

Set Xi to 

(Bj) 


Set Xi to 

(Bj) 

+ (Bk) 

Set Xi to 

(BO) 

- (Bk) 

Set Xi to 

(Bj) 

- (Bk) 

Set Xi to 

(Bj) 

- (Bk) 


OPEHATION VARIABtE 


30 bits 
30 bits 
30 bits 
30 bits 
15 bits 
15 bits 
15 bits 
15 bits 
15 bits 
15 bits 
15 bits 
15 bits 
15 bits 
15 bits 
15 bits 
15 bits 
15 bits 


COMMENTS 


30 



73ijk 

73ijk 

74ij0 

74ijk 

74ijk 

75ijk 

75ijk 

76ij0 

76ijk 

77i0k 

77ijk 

77ijk 



-ni + fl4 

ao-°4 
nr + nb 
n5-Pi 














8.5 CWU SYMBOLIC MACHINE INSTRUCTIONS 


The Compare/Move Unit (ClVtU) is a standard CPU hardware component of the CYBER 70 Series Model 
72 and Model 73, and optional on the Model 76 Computer ^sterns. It provides CPU instructions for 
moving and comparing data fields that consist of strings of 6-bit characters. Data fields can span word 

buu.id; les am am. begin and end at any character positicn within a A data field is specified by 

its lent th in characters and the location of its leftmost character (according to word address and 
eharacser position). Data fields cannot be in the operating registers nor in ECS. 

Each 60-bit word of a data field contains 10 character positions numbered 0 to 9 from left to right 
(high o rder to low order). 

COMP/ SS provides symbolic forms of the four CMU instructions plus a pseudo instruction used to 
generate a descriptor word to be referenced by the indirect move Instruction. Of the four instructions, 
the indirect move (IM) instruction is the only one that syntactically resembles other CPU lnstnicttoi.s. 
The ot? ev three instrwd.lon.s have formats dissimilar to CPU instructions and are generated thrcusgh 
COMP' SS pseudo instructicns. All of these kuitructions must begin at the top of a 60-bit word; 
COMPASS automatically forces upper before each of them unless the location £leld contains a minus 
sign. but IM are 60 bits in length, tm is 30 bits, but the hardware requires that the instruction be 
in the tj'per half of its word. The lov^or l>.ilf of the word is not executed. COMPASS automailcally 
forces ,j,ppar following IM, unless the next instrueticai has a minus sign in its location fleld. 


8.5.1 !M - INDIRECT MOVE 


The iivilract inOTe inst’.nction moves the contents of a data field to another location. It is a 30-bit 
instruction that specltles the address of a descriptor word which, in turn, contains the length and 
address ot the data fields. 


The deseriptcr word ia fetched from storage location (Bj)+ K. If the data field length is zero, Qie 
Instn .ition is executed as a pass but the execution time is longer. Otherwise, the content of the source 
Oei'i l>i moved t.j the destination field. If the two fields overlap, the results are undefined. The XO 


i C- iised for Ir'temsdiate 

completion cf the liiai.;ruction. 


■ug? 


r o-uotion :f the ;LnstructicD, and is cleared upon 


C^ratlon 

Variable 

Ixescnptiou 

Octal Code 

IM 

K 

Move lata according to word at K 

4640K 

IM 

Bj+iC 

Move data atoordiag to ward at (Bj)+ K 

464jK 

IM 


Move data according to word at (Bj) 

464j 000000 


60360900C 
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8.5.2 MD - INDIRECT MOVE DESCRIPTOR WORD 

The MD pseudo instruction generates a descriptor word for use by the indirect move (IM) instruction. 


Format: 


LOCATION 

OPERATION 

VARIABLE SUBfIElDS 

sym 

MD 



sym If present, sym is assigned the value of the location counter after the force upper occurs. It 
becomes the symbolic address of the descriptor word. 

f Absolute address expression specifying the field length in characters (0-8191). The upper 9 

bits (f) are placed in bits 56-48 of the descriptor word; the lower 4 bits (i) are placed in bits 29- 

An expression specifying the first word address of the source field in CM/SCM. 

*^s absolute expression (0-9) specifying the starting character position of the source field 

within the word at location k^. Characters are numbered from left to right. 

k^j An e.xpression specifying the first word address of the destination field in CM/SCM. 

I An absolute expression (0-9) specifying the starting character position of the destination field 

within the word at location k 

d 

Indirect Move Descriptor Word format: 


59_48_ 30 26 22 18 00 


0 


source 

rx: 

des 

destination 


12-4 

address 

^3-Och 
_1 

ch 

address 


Example: 


Code Generated 




LOCATION 

OPERATION 

VARIABLE COMMENTS 


1 


11 

IB IbO 

0U760050uG4ij05ij 070 0 0 

- 1 

DWORD 

MD 

• 

i 

10..0 , BUFFA,0,BUFFB,5 

4680010665 



• 

• 

IM 

DWORD ' 

1 


BUFFA is at address 2000; BUFFB is at address 3000 


6{t3609U9;': 
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8.5.3 DM - DIRECT MOVE 


The direct move (DM) pseudc instruction generates a CMU instruction that moves the contents of a 
data field to another data fielo. The m.achine instiaiction occupies one full woi-d and cannot be ai)lit 
between words. The instruction includes its own data field descriptor. 

If the a: ta ueld l8^llj^£h is zero, the instruction is executed as a pass, but the execution time is longer. 
Otherv.' se, the contents of the source field are moved to the destination field. If the two fields overlap, 
the results are undefined. The XO register is used for intermediate storage during e.xecution of the 
instruction and is cleared upon completion of the instruction. 

Format: 


LOCATION 

OPERATION 

VARIABLE SU8FIELDS 

sym 

■ 

1 

DM 

f,k ,c ,k,,c. 

’ s’ s d a 


syiri If present, sym is assigned the value of the location counter after the force upper occurs. 

It becomes the symbolic address of the instruction w.ord. 

H Absolute address expression specifying the field length in characters (0-127). 

u An expression specifying the first word add.re.ss of the source field in CM/SCM. 

■ s 

c An ab Olut/i ?xj:-re.'3aicn (0-9) specifying the starting character position of the source field 

^ within the word at location k . 

s 

k An expression specifyii^ the fir.st word address of the destination field in CM/SCM. 

d 

c An absolute expression (0~9) specifying the starting character position of the destination field 

^ within the M'ord at location k ,, Charmitei are numb-ered fro’n left to right, 

d 

Octal format of instruction- 


59 51 43 30 26 22 18 00 


- rn — 

, . e ! source 

—I—j— 

j jsrc des 
^3-dch ich 

1 , . i _ 1 _ 

des*- Inat Ion 

4o3 16-4 address 

1_1_1_J 

address 


60360900A 
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Exnmple: 


Code Generated 


LOCATION 

OPERATION 

variable comments 




II . 

18 1 30 

4657ii35JLiij 74j5ju7ulC 



OM j 

127, quFF A, c ,lFIUFFn, 5 


8.5.4 CC - COMPARE COLLATED 

The compare collated (CC) pseudo instruction generates a CMU instruction that compares the contents 
of two data fields, one character at a time, from left to right, until a pair of corresponding characters 
is found to have unequal collating values or until the data fields are exhausted. It is a 60-bit instruc¬ 
tion that occupies one full word. It cannot be split between two words. The instruction includes its 
own data field descriptor. Register AO contains the first word address of a table in storage that con¬ 
tains the collating values to be used in comparing characters. The result of the comparison is placed 
in register XO. 

The first word address of the collating table is obtained from register AO. The contents of the data 
fields are compared from left to right, one character at a time from each field, until two unequal 
characters are found. The collating value of each character is obtained from the collating table. If 
these values are equal, the compare continues until another character pair is unequal or until all 
characters have been compared. If the collating values are unequal, the two data fields are unequal 
and the field wich a larger collating value is the greater of the two fields. The collating values are 
treated as 6-bit unsigned integers. Note that two unequal characters could have the same collating 
value and would compare equal. 

Upon instruction completion, register XO contains a 60-bit signed integer as follows: 


(Field A)>(Field B) 
(Field A)= (Field B) 
(Field A)<(Field B) 


(XO) = f- n > 0 
(X0)= 0 

(XO) = n - £ < 0 


n is the number of pairs of characters that compared equal. If jf = 0, then (XO) is 0. 


60360S00B 


8-54 



The for nat of the collating table for six-bit characters is: 



59 

53 

<7 

41 

35 

29 

23 

27 11 

0 

(AO) 

00 

01 

02 

03 

04 

05 

06 

07 




i 0 

11 

JL 

13 

14 

15 

16 

17 


ilBi 



i 




i 



iisils 


(AO)+7 


71 

72 

73 

74 

75 

76 

77 


iilii 


Format: 


LOOmQN 


Variable sudiiEiDS 

i- 

1 sym 

j 

CC 



If present, sym is assigned the value of the location couiiter after the force upper occurs 
It becomes the symbolic address of the instruction. 


jf Absolute address expression specifying the field length in characters (0 - 127) 

k An expressicn specifying the first word address of the first data field in CM. 

a 

c An absolute expression specifying the starting character position of the first data field within 

^ the word at hocation k . Characters are timbered from left to right. 

a 

k^ An expression specifying the first wa rd aidress of the second data field in CM. 

c An absolute expression (0-9) specifying the starting character position of the second data field 

within the word at location 


Octal format of instruction: 


59 51 A8 30 26 22 18 00 



—j- 

1 first string 

H Its 

—» 1 
ss j secoiri string | 


I’6..% a Jdress 

J_l _ 

3-d ch 
u _ 

ch j adoruaa j 


Example: 

Code Generated 


5130013120 

46670050007405007000 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

t 


n 

ie 

|30 



S 10 

CC 

TCOLF 

127,3UFFA,0 

1 

,BUFFB,5 

f 


60360900A 
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8.5.5 CU - COMPARE UNCOLLATED 

The compare uncollated (CU) pseudo instruction generates a CMU instruction that compares the contents 
of two data fields, one character at a time, from left to right, until a pair of corresponding characters 
are found to have unequal values or until the data fields are exhausted. The machine instruction is a 
C)0-bit instruction that occupies one full word and cannot be split between two words. It includes its 
own data field descriptor. The result of the comparison is placed in register XO. 

Execution resembles the CC instruction except that AO and the collating table are not used. Instead, 
the characters are compared directly with each character regarded as a 6-bit unsigned binary integer. 
Register XO is set in the same manner as by the CC instruction. 

Format: 


LOCATION 

OPERATION 

variable SUBFIEIDS 

sym 

CU 

'•‘‘a’W'b 


sym If present, sym is assigned the value of the location counter after the force upper occurs. 

It becomes the symbolic address of the instruction. Absolute address expression (0-127) 
specifying the field length in characters. 

An expression specifying the first word address of the first' data field in CM, 

An absolute expression (0-9) specifying the starting character position of the first data field 
within the word at location k^. Characters are numbered from left to right. 

An expression specifying the first word address of the second data field in CM. 

Cj^ An absolute expression (0-9) specifying the starting character position of the second data 
field within the word at location k^^. 

Octal format of Instruction: 


59 51 48 

30 26 

o 

o 

GO 

CM 

CM 

467 

^6- 

_ 

firsc string 
^ address 

^3-C 

_ 

f S 
ch 

S3 

ch 

second string 
address 


Example: 

Code Ge ne rate d 

4o7rao5Ji;o74d5au?’ooo 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

] 


II 

IS Uo . 



CU 

1 

1 


603n^'-f' 
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PPU SYMBOLIC MACHINE INSTRUCTIONS 


9 


The COMPASS assembler recognizes symbolic notation for peripheral processor unit (PPU) 
instructions. When a PPU or PERIPH pseudo instruction is in the first statement group, the assembler 
identifies each sjanbolic instmction by name and generates a one word (12 bit) or t\^.'o word (24 bit) 
object Cide machine instruction under control of the current origin, location, and positicxi counters. 

All PPU code is absolute. Numeric data must be in integer notation. Floating point notation is illegal. 

9.1 MACHINE INSTRUCTION FORMATS 

All assen Died instrucuon has a 12-bii cr 24-Dit tormal. ilie 12-bit format has a 6-bit operation code f 
and a 6-bit operand d, A PPU accomplishes program indexing and manipulates operands in several 
modes. The 12-bit and 24-bit instruction formats provide for 6-bit, 12-bit, or 18-bit operands and 
6-bit or '! 2-hit addresses. Figures 9-1 and 9-2 illustrate the 12-bit instruction format and the 24-bit 
instruction format, respectively. 


Direct .Moder 

d = memory address of operand 


operation 

code 


(P) 


11 


06 0? 


00 


Indirect Mode: 

d = memory address of the address 
of the operand 

No Address Mode: 


d 6-bit operand, shift count, or 
relative addre.ss 


Other: 

d = special value; e. g., channel designator 
Figure 9-1. PPU 12-bit Instruction Format 


603609OOA 
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The 24-bit fontuit uses the 12-bit quantity m, which is the contents of the next program address (P + 1 
with d or the contents of d to form an 18-bit operand or a 12-bit operand address. 


operation 

code 



Figure 9-2. PPU 


Indexed Mode: 

d = address of the index for 
modifying the address of 
the operand 

m = base address of the operand 
(d) + m = address of operand 

Constant Mode: 

dm = 18-bit operand 

Other: 

dm = special values; e. g. , d = channel 
designator and m = 12-bit address 
of word count on 1AM and 0AM 
instructions 

-bit Instruction Format 


9.2 SYMBOLIC NOTATION 

This section describes notation used for coding sjmnbolic PPU machine instructions. Instructions are 
described in octal operation code sequence which generally reflects the mode of addressing. 
Instructions unique to a computer system are identified as such. 

The location field of a symbolic PPU machine instruction optionally contains a location symbol. Vv'iie; 
the S 5 rmboI is present, it is assigned the value of the location counter. 

The operation field of a symbolic PPU machine instruction contains a three-character name. 

The variable field contains one or two subfields. Each subfield contains an absolute or relocatable 
expression that reduces to a 6-bit, 12-bit, or 18-bit value. 

Designators used in this section are listed in Table 9-1. 

Generally, the third character of the instruction mnemonic (N, D, M, C, or 1) indicates the mode of 
addressing: 

N No operand address reference 
D Direct operand address: d contains operand 
M Memory address m or m + (d) contains operand 
C 18“bit constant 
I Indirect; operand address is (d) 


60360 ^ 00 ,' 
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TABLE 9-1. PERIPHERAL PROCESSOR INSTRUCTION DESIGNATORS 


r~ 

Designator 

Use 

A 

18-bit A register 

C 

An expression that reduce.s to an 18-bit operand value. 

c 

A 6-bit operand or operand address expression. 

ni 

A 12-bit expression value used with d or (d) to form an 18-bit operand or 12-bit 
operand address. 

p 

12-bit Program Address register 

Q 

12-bit Q register 


An expression that reduces to a 6-bit value (-37g < r< 37g) 
specifying relative address or shift count 

0 

Contents of a register or location 

(( )) 

Refers to indirect addressing 


Some cl the instructions provide similai' functions using different modes of addressing. They can be 
grouped according to function as shown below: 


Function 


Ds.ta transmission 


Description 

The following instructions either load data into the A register or store 
data from it. A load instruction loads a 6-bit, 12-bit, or 18-bit value 
as indicated by the instruction; any remaining upper bits of A are zeroed, 
except for the LCN instruction for which remaining bits are set to one. 

A store instnictior. store.s the lower 12 bits of the A register contents into 
a memory IcK-ation indicated by the instruction. 


h.© A 

aic not altered. 


lastruction 

Octal Code 

Section 

LDN 

14 

9. 2. 3 

LCN 

15 

8. 2. 3 

LDC 

20 

9. 2.4 

LDD 

30 

9. 2. 9 

STD 

Si 

•i.Z 9 

LD! 

40 

9.2.10 

STI 

44 

9. 2. 10 

LDM 

50 

9. 2.11 

STM 

54 

9. 2. 11 
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I’unction (cont'd) 


Description (cont'd) 


Arithmetic 


Logical 


A PPU arithmetic instruction adds or subtracts a 6-bit, 12-bit, or 
18-bit quantity from the contents of the A register and enters the result 
in A. 


Instruction 

Octal Code 

Section 

ADN 

16 

9.2.3 

SEN 

17 

9.2.3 

ADC 

21 

9.2.4 

ADD 

31 

9.2.6 

SBD 

32 

9. 2. 6 

ADI 

41 

9. 2. 7 

SBI 

42 

9.2.7 

ADM 

51 

Z£> 

00 

SBM 

52 

9.2.8 


A logical instruction forms a logical value in A using the contents of A 
as one of the operands and a 6-bit, 12-bit, or 18-bit value indicated by 
the instruction as the second operand. When the second operand is 
fewer than 18 bits, the remaining upper bits of A are unaltered, except 
for the LPN instruction for which the upper 12 bits are zeroed. 

Formation of a logical difference is equivalent to setting each bit in A 
that is unlike the corresponding bit in the second operand. For example. 

Initial (A) =0101 

Operand =1100 

Final (A) =1001 

Formation of a logical product is equivalent to setting a bit in A when 
the original setting of the bit in A and the corresponding bit in the second 
operand are both one's. 

For example. 

Initial (A) =0101 

t)perand = 1100 

Final (A) =0100 

A selective clear sets a bit zero in the A register wherever a bit is set 
in the second operand. For example. 

Initial (A) =0101 

Operand =1100 

Final (A) =0001 
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Function (cont'd) 


Description (cont'd) 


Logical (cont'd) 


Replace 


Logical instructions include the following: 

Instruction Cictal Code Section 


LMN 

11 

9.2,3 

LPN 

12 

9.2.3 

SCN 

13 

9,2.3 

LPC 

22 

9. 2,4 

LMC 

23 

9,2.4 

LIMD 

33 

9.2.9 

LMI 

43 

9,2.10 

I.MM 

53 

9. 2.11 


A replace instruction performs an arithmetic operation and returns the 
results X. the A register and the memorj, location from which one operand 
was obtained. The lower 12 bits of the result replaces the operand 
obtained from a memory location. 


Instruction 

Octal Code 

Section 

RAD 

35 

9.2.9 

AOD 

36 

9. 2. 9 

SOD 

37 

9.2.9 

RAI 

45 

9.2.10 

AOI 

46 

9. 2.10 

SOI 

47 

9.2,10 

RAM 

55 

9,2.11 

AO.M 

56 

9, 2.11 

SOM 

57 

9. 2,11 


9.2.1 BRANCH INSTRUCTIONS 

For br;mch instructions, the r subfield is a numeric value that indicates the number of locations to be 
jumped (maximum 31). When r is positive (01-37g), the jump is forward r locations. When r is 
negative (76 o-40q), the jump is backward 77g-r locations. In the following tests, negative zero 
(777777) is nonzero. For conditional instructions, when the test condition is true, the jump takes p ace 
When the condition is not met, execution continues with the next instruction. 


CAUTKIM 

The jump count must not be 00 or 77, If it is, execution 
loops on the jump instruction. 


The J option of the PPU instruction (Section 4.3.3) and the PERIPH instruction (Section 4.3.4) cause 
the value of the location counter to be subtracted from the value of the symbolic address (tag) before It 
is iilaced in the d field of the object code instruction. 


60360900A 
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Format.s: 


Operation 

Variable 

Description 

Size 

Octal Code 

LJM 

m, d 

Long jump to m+(d); if d = 0, m is not 
modified 

24 bits 

01 dm 

RJM 

m,d 

Return jump to m+(d); Store P+2 at m+(d) 
and jump to m+(d)+l. 

24 bits 

02 dm 

UJN 

rt 

Unconditional jump to P+r locations 

12 bits 

03d 

UJN 

tag 

Unconditional jump to tag 

12 bits 

03d 

ZJN 

r+ 

Zero jump; jump to P+r locations if 
(A) = 0 

12 bits 

04d 

ZJN 

tag 

Zero jump to tag 

12 bits 

04d 

NJN 

rt 

Nonzero jump; jump to P+r locations if 
(A) ^ 0 

12 bits 

05d 

NJN 

tag 

Nonzero jump to tag 

12 bits 

05d 

PJN 

rt 

Positive jump; jump to P+r locations if 
(A)>0 

12 bits 

06d 

PJN 

tag 

Positive jump to tag 

12 bits 

06d 

MJN 

rt 

Minus jump; jump to P+r locations if 
(A)< 0 

12 bits 

07d 

MJN 

tag 

Minus jump to tag 

12 bits 

07d 


+If PPU J or PERIPH J option has been selected, r is not valid. The contents of the variable field must 
be a symbolic address (tag). 


Examples; 


Code Generated 


lOCATlON 

OPERATION 

VARIABLE 

COMMENTS 




i 


n 

18 

Uo 


nioo 

1 762 



LJM 

<:T APT 

-^— 

i 


0271 

00 00 



PJM 

0 ,CT0 

1 

1 


0^71 




UJN 

TAGl-* 

1 


nan4 




7JN 

+ 4 

1 

1 


0625 




MJM 

TAG3 

1 

1 

i 






PJM 

TAGP-" 

i 

1 


0 726 


1 


MJN 

TAG4 

1 



In the above examples, the LJM instruction is at address 001 45 . TAGl is address 0012„, TAG2 has a 
value of ISg, TAGS has a value of 25g, and TAG4 has a value of 26g. ^ 
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Code Generated 1 

LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

i I 


n 

18 

1 30 









PPU ' 

1 

r 

1 

1 

0 3%7 



(IJNt 

Tafii 

i 

i 

oven 



7JN 

T fi G ’ 

1 In this example, the UJN is at 

1 address 0040. TAGI is address 

0 5‘16 



NJN 

Tftr.?-nn 

1 0010, TAG2 is 0011, TAGS is 

I address 0045, and TAG4 is 

06 n? 



PJN 

-ie‘‘'aG4 

1 address 0046. 

0 7 1 ^ 



MJN 

TaGi 

1 . 


I 

! 


9.2.2 SHIFT INSTRUCTION 

The SHN instruction shifts the contents of the A register right or left r places. If r is positive (+1 to 
+31), the shift is left circular r places; if r is negative (-31 to -1), the shift is end off r places to the 
right with no sign extension. No shift takes place when r is + 0. The assembler places the value of 
the r expression in the d field. If -31 >r >31 , the assembler generate.s an address error. 


Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

SHN 

r 

Shift (A) by + (left) or - (right) r bits 

12 bits 

lOd 


Examples: 


1. Shift contents of A left circular 6 places 


Code Generated 

n 

-1 

LO^'ATION i 

1 OPERAtlON 

1 vaiiabie comments 

1006 1 

7] 


' U 

16 1 30 



PHN 

p- 1 


2. Shift contents of A right end off 6 places 


Code Generated 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 



1 


tl 

IB 

iso 

1071 

6 


sc FT 1 

i 

ISC’ I 

iSHN I 

-S^MT 

i 

i 


60360900A 
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9.2.3 NO ADDRESS MODE INSTRUCTiONS 


In this mocie, during instruction execution, the contents of the d field are interpreted as a 6~bit 
positive operand. This mode eliminates the need for storing many constants in core. 

Formats: 


Operation 

Variable 

Description 

Size 

Octal Code 

LMN 

d 

Logical difference (A)-d-*A 

12 bits 

lid 

LPN 

d 

Logical product (A)*d -'A 

12 bits 

12d I 

SON 

d 

Selective clear (A) 

12 bits 

13d ; 

LDN 

d 

Load d-*A 

12 bits 

14d 1 

LCN 

d 

Load complement d — A 

12 bits 

15d 1 

ADN 

d 

Add (A)+d-*A 

12 bits 

16d 1 

SEN 

d 

Subtract (A)-d—A 

12 bits 

17d ! 


Examples: 


Code Generated 


lOCATION 

OPERATION 

VAftlABlE COMMENTS 


1 


II 

18 Iso 

1112 



LMN 

12B j 

1207 



LPN 

7 1 

1721 



SCN 

1 

21P 1 

10 


ifl 

SFT 

IFB 1 

l<4l 5 



LbN 

fla 

1614 



LCN 

1 

aA-1 1 

ion 1 



flON 

1 1 

170? 



SRN 

1 

? 1 
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9.2.4 CONSTANT MODE INSTRUCTIONS 


In this mode, during instruct) >n execution, the contents of the d and m fields are taken directly as an 
operand. This mode also eliminates the need for storing many constants. The assembler reduces 
absolute or relocatable expression c to an 18-bit value and stores the upper si.x bits in d and the lower 
12 bits in m. 


Format 


Operation 

Variable 

Description 

Size 

Octal Code 

LDC 

c 

Load c -*A 

24 bits 

( 

20 dm 

ADC 

c 

Add (A)+c —A 

24 bits 

21 dm 

LPC 


Logical product (A) *c —A 

24 bits 

22 dm 

I.MC 

_ J 

e 

_ _J 

Logical diffe^'ence (A)-c~*A 

24 bits 

23dm 


E.xamples: 

Code G enera ted 

?T70 7070 


?177 7776 

2707 0707 

2''C7 0 707 


70 70 7 



9.2.5 NO OPERATION INSTRUCTION 

The PSN instruction specifies that no operation is to be performed. It provides a means of padding 
a program. 


Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

PSN 


No operation (Pass) 

12 bits 

2400 


Example; 


Code Generated 


lOCAT-ON i 

O^tRAl IGn 

1 VARlAJlt COMMEKiS 

2(4 f’O 

) 


n 

18 i 3C 

h 


PSN 

-1-■ 

1 1 


60360900A 
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other octal operation codes (not generated by COMPASS) that act as pass instructions are: 


CYBER 70/Models 72, 73, 74 and 6000 Series CYBER 70/Model 76 and 7600 

00 25 

25 26 

27 

75 

76 


9.2.6 EXCHANGE JUMP INSTRUCTIONS (CYBER 70/MODEL 72, 73, 74, AND 6000-SERIES) 

The EXN instruction transmits an 18-bit (absolute) address of which only 17 bits are used from the A 
register to the CPU with a signal notifying the CPU to execute an exchange jump. The address in A is 
the starting location of the 16-word exchange package which contains information about the CPU pro¬ 
gram to be executed. The 18-bit initial address must be entered in A before the EXN instruction is 
executed. The CPU replaces the file with similar information from the interrupted CPU prc^ram. 

The PPU is not interrupted. 

The MXN instruction conditionally exchange jumps to the CPU and initiates CPU monitor activity. If 
the monitor flag bit is clear, this instruction sets the flag and initiates the exchange. If the monitor 
flag bit is set, this instruction acts as a pass instruction. The starting address for this exchange is 
the 18-bit address in the PPU A register. This address must be entered in A before the MXN instruc¬ 
tion is executed. 

Execution of MAN resembles MXN. However, the exchange package address is taken from the 18-bit 
Monitor Address (MA) register in CPU d, rather than from the PPU A register. 

In 6500 or 6700 systems (or CYBER 70/Model 72-2Z, 73-2Z, or 74-2Z) with dual central processors, 
d can be 0 or 1 and specifies which CPU the exchange jump will interrupt. In single processor systems, 
this value is not interpreted. 


Formats: 


Operation 

Variable 

Description 

Size 

Octal Code 

EXN 

d 

Exchange jump to CPU d 

12 bits 

260d 

MXN 

d 

Monitor exchange jump CPU d to (A) 

12 bits 

261d 

MANt 

d 

Monitor exchange jump CPU d to (MA) 

12 bits 

262d 


t CYBER 70/Models 72, 73 and 74 only. 


9-10 


60360900A 



Examples: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


H 

18 

ho 

2631 



EXN 

1 


26 .:u 



MXN 

0 

1 

26 IS 



MAN 

3 

1 

1 


9.2.7 READ PROGRAM ADDRESS INSTRUCTION (CYBER 70/MODELS 72, 73, 74, AND 6000-SERIES) 

This instruction transfers the contents of the CPU P register to the PPII A register; this allows the 
PPU to determine whether the CPU is in execution. In a dual central processor system, the lowest 
order bit of the instruction fonnat specifies which CPU P register is to be examined. In 6400 (or 
CYBER 70/Model 74) and 6600 (or CYBER 70/Model 74) systems, this bit is not Interpreted. The 
largest value that (P) can be is 17 bits. An ECS transfer is in progress when bit 17 of this instruction 
is set. However, bit 17 of P is not set. 


Format; 


OfJeratioi. 

Variable 

Description 

Size 

Octal Code 

RPN 

d 

Read program address CPU d — A 

12 bits 

27 Od 


Example: 


Code Generated 

D 

-j-, 

LOCATION j OPERATION 

VAftlABlE 

COMMENTS 

i 

ii 

i n ' 


ho 

27DC 


! PPN 1 

r-----1--- 

1 


60360900A 
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9.2.8 6416 PPU INSTRUCTIONS 


COMPASS a.sKcmbles the following instructions for execution on a 6416 computer system only. The 
K'l'N instruction initiates memory transfer operations by transmitting an 18-bit address from the 
i’PU A regi.ster to the 6416 16K memory. This address points to a word having the following format: 



59 36 18 00 

V--^ V--.X --^ 


Starting Address Starting Address Word Count 

in Extended Core Storage in 16 K Memory 


Expression d of this instruction specifies the transfer to be performed: 

If d is 0, K words ai'e transferred from ECS to 16K memory. 

If d is 1, K words are transferred from 16K memory to ECS. 

Note that addresses contained in the word are absolute addresses. Operating systems may require 
relocation (adding IIA to an address) and field length testing, e. g., Is address + RA FL? The 
Exchange Jump package contains RA and FL values for central memory and for extended core storage. 
The 6416 has no hardware for automatic relocation and field length testing; it is therefore incumbent 
upon the program to perform these functions whenever required by an operating system. 

The ERN instruction exfunines the status of the data trunk betw’een 16K memory and the extended core 
coupler. If the data trunk is busy (a transfer is in progress), a 1 is placed in the most significant bit 
position of the A register. If the trunk is free (not busy), the A register remains cleared. The d 
portion of this instruction is ignored. 

After execution of this instruction the program would typically test the A register for a sign before 
executing an instruction that initiates an ECS operation. 


Formats: 


Operation 

Variable 

Description 

Size 

Octal Code 

ETN 

d 

Extended core transfer 

12 bits 

26 Od 

ERN 

d 

Read extended core coupler status 

12 bits 

27 Od 


Examples: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE COMMENTS 

2600 

2700 

1 


1) 

18 ho 



ETN 

ERN 

-1- 

1 

1 

1 
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9.2.9 DIRECT ADDRESS MODE INSTRUCTIONS 


In this mode, during instruction execution, the contents of the d field specify the address of the operand. 
During assembly, the assembler reduces absolute or relocatable expression d to a 6-bit value that 
specifies one of the first lOOg addresses in core memory (0000 - 0077g), During instruction execution, 
(d) is treated as a positive 12-bit quantity. 

Format 


Operatic 1 

Variable 

Description 

Size 

Octal Code 

LDD 

d 

Load (d)—A 

12 bits 

30d 

ADD 

d 

Add (A) + (d) —A 

12 bits 

31d 

SBD 

d 

Subtract (A) - (d) -*A 

12 bits 

32d 

LMD 

d 

Logical difference (A) and (d) —A 

12 bits 

33d ! 

S'l'D 

(i 

Store 

12 bits 

34d 1 

RAD 

d 

Replace add (d) + (A)—»d and A 

12 bits 

35d 

AOD 

d 

Replace add (d) + 1 —d and A 

12 bit.s 

36d 

SOD 

d 

Replace subtract one (d) - 1—d and A 

12 bits 

_.„J 


Examples; 


Code Generated 


location 

OPERA’iON 

VARiA8lf 

COMMENTS 


1 


M 

18 

ho 

301 ? 



Lm 

IflGl 

—1- 

1 

3in'’ 


! 


T A r, ? - 1 013 

1 

1 

0 


i 

•~-tq 


1 

1 

33?7 



1CO ' ISB 

( 

1 



|sTq 1 

1 

1 

1 


! 

kan 1 

S 5 0 

( 

3612 


jf'OO 

1 

Tfif.l 


3713 


jcnn 

1 

T A, f; ? 

1 

i 


60360900A 
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9.2.10 INDIRECT ADDRESS MODE INSTRUCTIONS 


In this mode, during instruction execution, d specifies an address, the contents of which specify the 
address of the desired operand. Thus, d specifies the operand address indirectly. 

During assembly, the assembler reduces absolute or relocatable expression d to a 6-bit value that 
specifies one of the first 100^ addresses in core memory (0000 - 0077^). 

On the 7600 (or CYBER 70/Model 76), the address formed permits referencing of all memory locations 
but one (0000 - 7776^). 

8 

On a 6000 Series Computer System (or CYBER 70/Model 72, 73, or 74) PPU, the address formed in 
indirect address mode permits referencing of all memory locations, including address 7777 . 

Formats: ® 


Ojje ration 

Variable 

Description 

Size 

Octal Code 

LDI 

d 

Load ((d))—A 

12 bits 

40d 

ADI 

d 

Add (A) + ((d))—A 

12 bits 

41 d 

SBI 

d 

Subtract (A) - ((d))—A 

12 bits 

42d 

LMI 

d 

Logical difference (A) - ((d))—A 

12 bits 

43d 

STI 

d 

Store (A)—(d) 

12 bits 

44d j 

RAI 

d 

Replace add ((d)) + (A) —(d) and A 

12 bits 

45d 

AOI 

d 

Replace add one ((d)) + 1 —(d) and A 

12 bits 

46d 

SOI 

d 

Replace subtract one ((d)) - 1 —(d) and A 

12 bits 

47d 


Examples: 


Code Generated 

LOCATION 

OPERATION 

va«iabu comments 


f" 


It 

18 |30 

4 1) 1 p 

1 

1 


Lor 

T A G 1 1 

'-tlOJ 

i 

1 


flor 

TAG2-10 1 

4? 7 0 



SOT 

40° 1 

4 327 



LMT 

I 

TflQI+150 1 

4 4()1 



stt 

1 

1 1 

4 'i S 5 



PAT 

1 

S'iR I 

4 1 ? 



APT 

1 

TAGI i 

4 7 13 



SOT 

1 

tag? 1 


60360fii'''; H 
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9.2.11 INDEXED DIRECT ADDRESS MODE INSTRUCTIONS 


In this mode, during instruction execution, the value formed by m+(d) is used as the address of the 
operand. During assembly, tiie assembler reduces absolute or relocatable expression d to a 6-bit 
value that specifies one of the first lOOg addresses in core memory (0000 - 00770). The value of 
absolute or relocatable expression m is a 12-bit base address. 


NOTE 


The address formed in indexed addressing permits 
referencing of all memory locations but one 
(0000-7776g). Although m and/or (d) can have a 
value of 777?g. 'he computer S 3 ^’stem does not 
permit m+(d) to reference address 77770. 


When in indexed direct address mode, if d is nonzero the contents of address d are added to m to 
produce a 12-bit operand address (indexed addressing). If d is zero, m is taken as the operand address. 


Formats: 


Operation 

» Variable 

Description 

— 

Size 

- -, 

Octal Code 

LDM 

m,d 

Load (m+(d))-*A 

24 bits 

50dm 

ADM 

m,d 

Add (m+(d))-*-A 

24 bits 

51dm 

SBM 

m,d 

Subtract (m+(d))—A 

24 bits 

52dm 

LMM 

m,d 

Logical difference (A) - (m+(d))-*A 

24 bits 

53dm 

STM 

m,d 

Store (A)~*m+(d) 

24 bits 

54dm 

RAM 

m,d 

Replace aud im-'{dp - vA)-—a:,-(d) and A 

24 bits 

55dm 

AOM 

m,d 

Replace add aie (n*. + x —m+(d) and A 

24 bits 

56dm 

SOM 

m,d 

Replace subtract one (m-r(d)) - 1—►m+ld) 
and A 

24 bits 

57dm 


Examples: 

Code Generated 

■] 

lOCAflOr^ 

O/'tfcATlON 

<AsiAaic comments 

1 

I 

II 

18 iso 

5077 

0203 


1-- 

\ 

---(--- 

7FP ! 

SlOet 




1 «0d 

i&L5,b 

5200 

0202 



SBh 

TAGS j 

5315 

7000 


1 

i 

I.MK 

7 0003rl&B 1 

[ 

5410 

0272 


i 

i 

Sin 

1 

5500 

0342 


1 

RAM 

1408-I’TAG5,0 ^ 

5600 

0173 



AOM 

-lOB+TAGb 1 

1 

5712 

0203 


1 

1 

SOM 

TAGS.TAGI 1 


60360900C 
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9.2.12 CENTRAL READ/WRITE INSTRUCTIONS (CYBER 70/MODELS 72, 73, 74 AND 6000-SERIESj 

I'he CRD instruction transfers a 60-bit word from central memory to five consecutive PPU locations, 
ihc 18-bit address of the central memory location must be loaded into A prior to executing this 
instruction. (Note that this is an absolute address.) The 60-bit word is disassembled into five 12-bit 
words beginning at the left. Location d receives the first 12-bit word. The remaining 12-bit words 
go to successive locations. The (A) are not altered. 

The CRM instruction reads a block of 60-bit words from central memory. The content of location d 
gives the block length. The 18-bit address of the first central word must be loaded into A prior to 
executing this instruction. (Note that this is an absolute address.) During the execution of the instruc¬ 
tion, (P) goes to processor address 0 and P holds m. Also, (d) goes to the Q register where it is 
reduced by one as each central word is processed. The original content of P is restored at the end of 
the instruction. 

(A) is advanced by one to provide the next central memory address after each 60-bit word is disassembled 
and stored. The contents of the Q register are also reduced by one. The block transfer is complete 
when (Q)=0. The block of central memory locations proceeds from address (A) to address (A) + (d) -1. 

The block of processor memory locations proceeds from address m to m+5(d)-l. 

Each central word is disassembled into five 12-bit words beginning with the high-order 12 bits. The 
first word is stored at processor memory location m. The content of P (which is holding m) is advanced 
by one to provide the next address in the processor memory as each 12-bit word is stored. If P overflows, 
operation continues as P is advanced from 7777g to 0000^. These locations will be written into as if 
they were consecutive. 

The CWD instruction assembles five successive 12-bit words into a 60-bit word and stores the word 
in central memory. The 18-bit address word designating the central memory location must be in A 
prior to execution of the instruction. (Note that this is an absolute address.) 

Location d holds the first word to be read out of the processor memory. This word appears as the 
higher order 12 bits of the 60-bit word to be stored in central memory. The remaining words are taken 
from successive addresses. 

Ihc ( VVM instruction as.semble.s a block of 60-bit words and writes them in central memory. The content 
of location d givc.s the number of 60-bit words. The content of'the A register gives the beginning 
ca’iitral memory addre.ss. (Note that this is an absolute address.) During the execution of this instruction 
(!’) goes to processor addre.ss 0, and 1’ holds m. Also, (d) goes to the Q register, where it is reduced 
by one ;is emch central word is assembled. The original content of P is restored at the end of the 
instruction. 

I he content of P (the m portion of the instruction) gives the address of the first word to be read out of 
the processor memory. This word appears as the higher order 12 bits of the first 60-bit word to be 
•storcfl in central memory. 

1 he content of P is advanced by one to provide the next address in the processor memory as each 
12-bit word is read. If P overflo\v.s, operation continues as P is advanced from 7777g to OOOOg. 

I'he.se locations will be read from as if they were consecutive. 

(A) i.s advanced by one to provide the next central memory address after each 60-bit word is assembled. 
Also, Q is reduced by one. The block transfer is complete when (Q)=0. 
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Form its: 


,1^ 




Operation 

Variable 

Description 

Size 

Octal Code 

CRD 

d 

Central read from (A) to d 

12 bits 

60d 

CRM 

m,d+ 

Central read from (d) CM words begin¬ 
ning .si ■ M {A)“* i tqi m 

M bits 

61 din 

CWD 

d 

Central write fiTini d to (.Al 

12 bits 

6 2d 

CWM 

m,d+ 

Ceiitrai wiile (d) words beginning at 

PPU m-* CM (A) 

24 bits 

63dm 


fExpression d is required. 
Example; 

Code Generated 

e, n ’ f, 

6i2f. nnt? 

h"3? 

0012 


i ! 


1 OPFRATION 

VAKIABLE COMMENTS 



'8 \ 30 


Tr iT 

i h p ^ 


CRM 

TAf.l,26B j 


C S'H 

! 

•J t. > ' i 


CWH 

TAGltSOn ! 

1 


9.2.13 I/O BRANCH INSTRUCr'ON.S (CYBER 70/MODEL.S 72 , 73, 74 AND 6000-SERIE.S i 

The following instructions are conditional long jump instructions, each of which tests for a condition 
on channel d. When the condition is true, ibc juri!;> to address m takes place. When the condition is 
not met, execution continues with the next instruction. These instructions are exclusividy 6000-series 
PPU instnictions. The d expres.sion is required 

For the I'JM irstruction, an iniiut cham -* rs C.C- ■ • 'i th-,- ’c; vt equipment ha:- .sent b. word to the channel 
register and sets the full flag. The civ^rr.'-l lo-jia-es full antH the PPU accepts the word and clears the 
flag. An output channel remains full '-.h--; a a Pii asuis e. word to the channel register and sets the 
full flag. The channel is empty v. hen mo ujir'ui equipimeni accepts the word and notifies the PPU. 






.. 0 ^. 


Formats: 


Operation 

Variiible 

Descripiiun 

Si ze 

Octal Code 

A-JM 

ir.,d 

Jump t; ni C 



24 bitsi 

64dm 

lJIw 

ir,, d 

Ur n'; 

• 

i.-ini : i.i i .1* J ■/U: 


L'i iH 

65 dm 

FJM 

m,d 

Jump to m if 

channel d full 


2.1 bits 

66dm 

EJM 

m,d 

Jump to in if 

ch.ai!ne1 d empty 


24 bits 

67dm 
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Examples: 


Code Generated 


6<«02 

0012 

6502 

0013 

6604 

0025 

6704 

0026 



9.2.14 I/O BRANCH INSTRUCTIONS (CYBER 70/MODEL 76 AND 7600) 

The following instructions are conditional long jump instructions each of which tests a condition on 
channel d. When the condition is true, the jump to address m takes place. When the condition is not 
met, execution continues with the next instruction. These instructions are exclusively 7600 PPU 
instructions. The d expression is required. 

Formats: 


Operation 

Variable 

Description 

Size 

Octal Code 

FIM 

m,d 

Jump to m on channel d input word flag 

24 bits 

60dm 

EIM 

m, d 

Jump to m if no input word flag on channel d 

24 bits 

61dm 

IRM 

m,d 

Jump to m on channel d input record flag 

24 bits 

62dm 

NIM 

m,d 

Jump to m if no input record flag on 
channel d 

24 bits 

63dm 

FOM 

m,d 

Jump to m on channel d output word flag 

24 bits 

64dm 

EOM 

m, d 

Jump to m if no output word flag on 
channel d 

24 bits 

65dm 

ORM 

m, d 

Jump to m on channel d output record flag 

24 bits 

66dm 

NOM 

m, d 

Jump to m if no output record flag on 
channel d 

24 bits 

67 dm 
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Examplf s; 


Code ( 

Ano5 

Dlf*2 

.5>ni 

6^04 

b415 

r,Rr!0 

66C1 

0705 


fene rated 


LOCATION 

OPERATION 

VAdlABlE COMMENTS 


1 


n 

IB ho 

1765 



FIM 

TftG6,5 j 

i ■^65 



F IH 

1^05,2 1 

1 766 



IRH 

1 

TftG6,l j 

4 


rnsN 

SFT 

. j 

1 ■^66 



MIM 

Tfl&6,rHflN j 

7000 



FOH 

70000,15^ 1 

io?*; 



£OM 

i(,r:n + T sr,5,0 | 

1206 



ORM 

i 

-lO'^R+TAGe^CHAM-i 

j 

1766 



NOfl 

TAG6,nHflN+l ! 
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9.2.15 A REGISTER INPUT/OUTPUT INSTRUCTIONS 

The following instructions transfer a word to or from channel d and the lower 12 bits of the A register. 

On the CYBER 70/Model 76 or 7600, the IAN instruction is not executed until the input channel d word 
flag is set. If the flag is not set when the instruction is read, execution halts until an external signal 
sets the flag. The input channel d record flag does not affect the IAN execution. The IAN instruction 
clears the input channel d word flag and record flag and transmits a resume signal over the input cable 
after the word is entered in the A register. 

On the CYBER 70/Model 76 or 7600, the OAN instruction is not executed while the output channel d 
word flag is set. If the flag is set, execution stops until an external resume signal clears the flag. 

This instruction sets the output channel d word flag and transmits a work pulse over the output channel 
cable. 

On a CYBER 70/Model 72, 73, or 74 or 6000-series machine, executing either of these instructions 
when the channel is inactive causes the peripheral processor unit to become inoperative until some 
other peripheral processor activates the channel or the system is deadstarted. 

Formats: 


Operation 

Variable 

Description 

Size 

Octal Code 

IAN 

d 

Input: channeld to A 

12 bits 

70d 

OAN 

d 

Output: (A) to channel d 

12 bits 

72d 


Examples: 

Code Generated 
7003 
7204 



lOCATlON 

OPERATION 

VAIIUBIE 

COMMENTS 

1 


n 

18 

|30 



IflN 

3 

-1—- 

1 



OflN 

CHAN 

1 


9.2.16 BLOCK INPUT/OUTPUT INSTRUCTIONS 

The following instructions transfer a block of 12-bit words on channel d to or from a starting PPU 
memory location specified by m. The number of words transferred is specified by the contents of the 
A register which is reduced by one as each word is transferred. The operation is completed when (A) 
= 0 or the channel becomes inactive (CYBER 70/Model 72, 73, 74 or 6000 only). 


On a CYBER 70/Model 72, 73, 74 or 6000-series machine, the input operation is complete when (A) = 0 
or the data channel becomes inactive. If the operation is terminated by the channel becoming inactive, 
the next location in the processor memory is set to all zeros. The word count is not affected by this 
empty word. Therefore, the contents of the A register gives the block length minus the number of real 
data words actually read in. 

During execution of either of these instructions, address 0000 temporarily holds P, while the P register 
holds m. 'ITie contents of P advances by one to give the address for the next word as each word is 
transferred. 
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NOTE 


If this instruction is executed on a 6000-series machine 
when ihe data channel is inactive, no operation is accom¬ 
plished and the program continues at P + 2. However, 
the location specified by m is set to all zeros for the lAM 
instructioru 

On a CYBER 70/Model 76 or 7600 the 1AM instniction is not executed until the input channel d word 
flag is set. If the flag is not set when the instruction is read, execution halts until an external signal 
sets the flag. The presence of an input chamiel d record ilag is ignored for the first word of the block 
but terminates the block input at any word after the first. In this case, the next location in the PPU 
block input storage area contains a noise woici; any remaimng locations are unaltered. Note tiiat the 
storage location can be incremented tlirough location 7776^ to 0000 on a 7600 (or CYBER 70/Motiel 76), 
or location 7777 through 0000 on a 600{>“series machine (or a CYBini. 70/Model 72. 73, or 74), wun h 
could c estroy existing data or a program. 

On a CYBER 70/Model 76 or 7600, the OAM instruction is not executed until the output channel d word 
flag is cleared. If the flag is set when the instruction is read, execution halts until a resume pulse 
clears the flag. An output chamiel d record tlag does not affect OAM execution. 


Formats: 


r 

Operation 

- 

Variable 

Itescrij'i'. a 

■ 

Size 

a 

Octal Code j 

lAM 

m,d t 

Input ; (As words to m from channel d 

24 bits 

! 

71dm ! 

OAM 

m,d T 

Output: (A) words to channel d from ni 

24 bits 

73dm j 


t Express ion d is required. 


Examples; 


Code Gensrareo 

1 ICC^TIO'' 1 VAI>'*8lf 

COMMENTS 



1 30 


7103 nbt- j 

1 

; i ' t 



77P4 i 

i 1 lo's'- |T6n,i* 

1 
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9.2.17 SET OUTPUT RECORD FLAG INSTRUCTION (CYBER 70/MODEL 76 AND 7600) 


The RFN instruction sets the output channel d record flag and transmits a record pulse over the cable. 
The instruction ignores the previous status of the channel d flags; the instruction is executed even if the 
output channel d record flag is set. 


Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

RFN 

d 

Set output record flag on channel d 

12 bits 

74d 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


I 


11 

It 

ho 






7406 



RFN ' 

6 

1 

i 


9.2.18 CHANNEL FUNCTION INSTRUCTIONS (CYBER 70/MODELS 72, 73, 74 AND 6000-SERIES) 

The ACN instruction activates the channel specified by d. This instruction must precede the IAN, 

LAM, 0AM, or OAN instructions. Activating a channel alerts the input/output equipment for the 
exchange of data. Activating an already active channel causes the PPU to become inoperative until 
another PPU or an external equipment deactivates the channel, or the system is deadstarted. 

The DCN instruction deactivates the channel specified by expression d. It stops the input/output 
equipment and terminates the buffer. Deactivating an already inactive channel causes the PPU to 
become inoperative until deadstart or until the channel is activated. Avoid disconnecting the 
channel before first sensing for channel empty, deactivating a channel before stopping the associated 
processor, or deactivating a channel before placing a useful program into the associated processor. 
After deadstart, PPUs wait on an input channel. Deactivating a channel after deadstart causes an 
exit to address 0001 and execution of the program. 

The FAN instruction sends the external function code from the lower 12 bits of the A register on 
channel d. 

The FNC instruction sends the external function code specified by m on channel d. For this instruction, 
expression d is required. 

Execution of a FAN or FNC instruction when the channel is active causes the PPU to become inoperative 
until another PPU or an external equipment deactivates the channel, or the system is deadstarted. 

Formats: 


Operation 

Variable 

Description 

Size 

Octal Code 

ACN 

d 

Activate channel d 

12 bits 

74d 

DCN 

d 

Disconnect channel d 

12 bits 

75d 

FAN 

d 

Function (A) on channel d 

12 bits 

76d 

FNC 

c, d 

Function c on channel d 

24 bits 

77dm 
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Example 3: 




LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


n 

16 

1 30 

7405 



ACN 

5 

-1.. 

1 

7504 



DC 

CHAM 

1 

76C5 



FAN 

CHAN4-1 

( 

1 

7705 0020 



FNC 

?CP,,5 

1 

i 


9.2.19 ERROR STOP INSTRUCTION (CYBER 70/MODEl 76 AND 7600) 

The ESN instruction baits execution of the peripheral processor prc^ram and indicates a program 
error condition to the monitor control unit. The FPU nuiSt be restarted by a deadstart sequence from 
the MCU, only. 

Format: 


Ope ration 

Variable 

Description 

Size 

Octal Code 

j ESN 

d 

Error Slop 

12 bits 

7700 


Example: 


Code Generated 


LOCATION 1 

OPfRA'iiON 

VARIABLE 

COMMENTS 


) 


li 

le 

|30 

7700 




. —p-'- ■ ^ 
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PROGRAM EXECUTION 


10 


COMPASS can be called from the librai? and placed in execution through a COMPASS call card o 
through an IDENT statement (Section 4. 2.1) in a FORTRAN source deck. When COMPASS is called 
through FORTRAN, parameters are ordinarily specified on the RUN or FTN card and are the same as 

for the FORTRAN program. 

10.1 CONTROL STATEMENTS 

Normally, assembly of COAIPASS source programs or the execution of CPU binary object decks 
done from a job file. A file is usually submitted in the form of card decks or card images. The 
first section of the file must contain the control statements described in this section. Other 
optional statements are described in the operating system reference manual. Following the control 
statement section are one or more sections containing source statements and data. A control 
statement ke>- w ord begins with the first iion-biank character on the card. A comma or a left 
parenthesis or blank begins a parameter string. Parameters in the string are separated by com¬ 
mas. A period or right parenthesis terminates a parameter string. Comments optionally follow the 
terminator. Within the parameter strings, blanks are ignored. Ordinarily, a parameter can contain 
only letters and digits. When a parameter is enclosed between dollar signs, all characters are 
permitted and blanks are net ignored. Within such a dollar-sign delimited parameter, two con¬ 
secutive dollar signs represent a single dollar sign. 

10.1.1 JOB STATEMENT 

A job statement of the following format must ’'e the fi-st statement in the deck. The parameters 
following name can be in any order or can be o,nitted For any omitted field a default value is supplied 
which is an installation option. 

Format: 


name, Tt, CMscm, EClem. 


name 1-7 letters or digits by which the jol.) is ulentified. 

The first character must be a letter. 


00:J 00900 D 
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Tt 


CPU time limit in octal seconds (1-7777^), must be sufficient to process all control 
cards for the job, including assembly and execution. 

CMscm Estimate of maximum amount of SCM or CM required for execution (1-6 octal digits). 
The estimate for COMPASS is a minimum of 40000. 

EClcm Estimate of maximum amount of LCM or ECS in octal thousands, required for 

assembly or execution (1 - 1400„). The estimate for COMPASS is a minimum of 

8 

none. 

COMPASS notes storage used in the job dayfile. For subsequent runs, the field lengths can be de¬ 
creased accordingly. 

Examples: 



10.1.2 COMPASS CALL STATEMENT 

The following statement causes the COMPASS assembler to be loaded from the library and executed. 
Parameters specify modes and files. 

Format: 

^COMPASS(p^,P2,...,Pj^) 

The optional parameters, p, may be in any order within the parentheses. A parameter can be omitted 
or can be in one of the following forms. 

mode 

mode = 0 

mode = Ifn 

Mode is one or two characters as described below; Ifn is a 1 - 7 character name of a file or a 
character string. 
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Mode 


Significance 


A - Abort mode 
A 

omitted 

B - Binary output 
omitted or B 
B=0 
&=lfn 

D - Debug mode 
D 

omitted 


F - FORTRAN mode; 

omitted or F 

F=number 

F=name 


G - Get system text 
Omitted or G=0 
G 

G=l£n 
G=lfn/ovl 


Abort job at end of run to EXIT(S) statement if any assembly errors occurred. | 

Do not abort job fur assembh- urrors 

Binary on the load-and-go file (LGO) 

No.binary output 
Binary on the named file 


Binary is germrated on the file indicated by B parameter in spite of assembly er r'> •*? 
and regardless of the abort mode (A parameter) 

D is ignored if B==0 

Assembly errors inhibit binary output. In abort mode (A parameter present), no 
binary output is written at all for a subprogram containing assembly errors. Other- 
wise (A parimieter omitted), the message ERRORS IN ASSEMBLY is written to the 
file indicated by the B parameter for each subprogram containing assembly errors. 

establishes value of special element *F 
*F is 0 

*F is number (one decimal digit) 

*F is a number corresponding to name as follows: 

COMPASS - 0 
RUN 1 
FTN = 2 


Load no system text from a sequential binary file 

Load the first system text overlay, if any, from file named SYSTEXT 

Load the first system lext overlay, if any, in the specified sequential binary file 

Search the specified sequential binary file for a system text overlay whose name 
is ovl and load the first such overlay 
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Mode 


Significance 


I - Source of assembler input 

omitted Source deck is on INPUT file 

I Source deck is on COMPILE file in either compressed or expanded format. 

1=0 Illegal 

I=lfn Source deck is on named file 


L - Full List 
omitted or L 
L=lfn 


L=0 


List output on OUTPUT file 

List output on named file. When the full list Is on a different file than the short 
list, the listing for each subprc^ram is preceded by a one-word header consisting 
of an asterisk and the first six characters of the subprogram name. This header 
identifies the subprogram as a convenience for sorting and cataloging. Also see 
O option. 

No full list will be generated 


LO-List options; selects or deselects a maximum of nine of the list options A, B, C, D E F G L 
M, N, R, S, T, or X .... 

omitted or LO=0 Same as selecting B, L, N, and R only 

Selects list options C, F, G, and X, and deselects R 


LO 




LO=$$$$ 


A list of up to nine characters. Inclusion of B, L, N, or R deselects the corres* 
ponding option. Otherwise, inclusion of a character selects the option. For 
options, refer to LIST pseudo instruction, section 4.11.1. 


Selects all list options 
ML-Initial Value of MODLEVEL Micro 

omitted or ML MODLEVEL is defined equal to JDATE at the start of each assembly 


ML-string MODLEVEL is defined as string (nine characters maximum) at the start of each 

assembly 

N - No eject; suppresses ejects caused by normal listing control. The only page ejects are at the be¬ 
ginning of new subprograms. 

N No eject 

omitted Normal ejects 
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O - Shoit list; suppressed if full list is directed to the same file or if no assembly errors occur. How¬ 
ever, if the full list and short list are on different files (for example, the full list is written on 
OUTPUT and the short list is written on the named file), the short list will be augmented by the 
addition of any error lines originating with a macro call. 

omitted or O List output on OUTPUT file 

0=lfn List output on named file 

0=0 No short list will be generated 

P - Continue page 

P Page numbering continues from subprogram to subprogram, 

omitted Page numbering begins with i at the start of each subprogram 

PC- Initial Value of PCOMMENT Micro 

omitted or PC PCOMMENT is defined as 30 blanks at the start of each assembly 

PC=string PCOMMENT is defined as string at the start of each assembly. Characters are 

truncated from the right or blanks are appended to the right, as necessary, so 
that the length cf the micro value is exactly 30 characters. 

S - System Text Name 

omitted If there are no G parameters other than G=0, load the overlay named SYSTEXT 

from the job's current global library set. 

Load no system text from a library 

Load system text overlay named SYSTEXT from job's current global library set 

Load the S 3 ^stem text overlay named ovl from the job's current global library set 

Load the system text overlay named ovl from the library named lib, which may be 
a user library file or a system Ubrar>' 

X - Source of external text (XTEXTi when location field of XTEXT pseudo instruction is blank. 


omitted 

External text OLDPL file 

X=lfn 

External text on named file 

X=0 

Illegal 

X 

External text on OPL file. 


Reads source from INPUT, writes the binary output to LGO, 
and the listing to OUTPUT. Assemble in debug mode with 
system text from overlay OVI in the global library set. 

Disables LIST pseudo instruction and sets LIST options 
A, S, G, X, and D. 

Uses the standard default options. 


Examples: 


COM PASS(B, D, S=OVI) 




COMPASS(LO=ASGXD) 


COM PASS. 


S=0 

S 

S=ovl 

S=lib/ovl 
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MULTIPLE SYSTEM TEXT OVERLAYS 


COMPASS 3 allows up to seven system text overlays to be used for an assembler run. They are 
specified by G and S parameters on the COMPASS control card. Each G parameter (except G=0) 
specifies loading of a system text overlay from a sequential binary file, and each S parameter (except 
I S=0) specifies loading of a system text overlay from a user library file or a system library. The G and 
S parameters can be used in any combination and in any order, and can be intermixed freely with other 
parameters, provided the total number of system text overlays specified does not exceed seven. 
COMPASS loads the system text overlays in the order in which the G and S parameters occur on the 
COMPASS card. If a system macro, micro, or symbol is defined by more than one system text, only 
the last definition is used. 

Examples; 


/COMPASS(I,S,S=PFMTEXT, G=MYTEXT) Reads source from file COMPILE and gets system 

text from overlays SYSTEXT and PFMTEXT in the 
global library set, and from the local file MYTEXT 

/ ~~ 

C0MPASS(G-FILE/SCPTEXT,S=MYLIB/TEXT) Get system text from overlay SCPTEXT on the file 

FILE, and from overlay TEXT in library MYLIB. 


10.1.3 LGO CONTROL STATEMENT 

An LGO control statement calls for the loading and execution of CPU binary output produced by the 
assembler when the B option on the COMPASS card is selected. When binary output is on some file 
other than LGO, the card is replaced by a program call card for that file. The file is automatically 
rewound before loading. The LGO file is temporary; it is released at job termination. 


Formats: 

f^LGO(p^,P2,Pg.Pjj) 


or 


f LGO, 


10.1.4 PROGRAM CALL STATEMENT 

The program call statement directs the operating system to search for a file or CPU program that has 
the name specified on the card, load it into the user's small core memory, and execute it as a CPU 
program. 
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Formats: 


name(p^,P2,...,Pj^) 

name Program name 

Pj Parameters in a format acceptable to the program being called 

When the operating system locates the file, it begins loading it from the current file position and, vidien 
loading is complete, executes the program as a CPU program. 


10.1.5 7/8/9 CARD 

The card that separates sections in the job deck is characterized by having rows 7, 8, and 9 punched in 
column one. The level is assumed zero unless columns 2 and 3 contain an octal level number punched 
in Hollerith code. The remainder of the columns optionally contain comments. 

As an example, a deck consisting of a control card section and a COMPASS source input section would 
include two 7/8/9 cards. The first terminates the control cards and the second terminates COMPASS 
input. 


10.1.6 6/7/8/9 CARD 

The card that signals the end of the job deck is characterized by having rows 6, 7, 8 and 9 punched in 
column one. Columns 2-80 optionally contain comments. 


10.1.7 KRONOS ACCOUNT CARD 

The control card format is; 


ACCOUNT, usemum, passwrd. 


usemum 

passwrd 

System processor; 
Macro used: 
Function processor; 


User (account) number 

User password 

not applicable 

not applicable 

lAJ 


The ACCOUNT card in KRONOS follows the job card and specifies the user number and password. The 

user number is used in system bookeeping and defines the user’s file catalog area. The user 

can specify a different permanent file catalog during job processing by issuing another ACCOUNT card. 

The samples which follow do not have KRONOS ACCOUNT cards. 
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10.2 SAMPLE DECKS 


The following job calls for assembly of the source program and execution of the binary object program 

f ‘■““"'b'y- COMPASS reads source staten,e„ls from file INPUT, wriLs the llsu4 on 

Z Z J' I 7 " ” ““‘Sipept LGO calls for execution of 

the binary object program, which obtains its data from file INPUT. 



Data for 
execution 
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In the following job, the COMPASS assembler is called twice. During the first assembly, binary 
object decks for subprograms TESTl and TEST2 are written on file LGFILEl. The source decks for 
these subprograms are in the second section of the INPUT file. EXiring the second assembly, COM¬ 
PASS writes a binary object deck for subprogram CDA on file LGFILE2. Each assembler run produces 
a full listing. Following the second assembly, both files containing binary output are repositioned to 
the beginning of the file. Then, the COPYBR pregram is called to copy the contents of LGFILE2 to a 
punch file (PUNCHB). The LGFILEl statement then calls for the loading and execution of subprograms 
TESTl and TEST2 from LGFILEl. Following successful execution of the subprograms, the file is re¬ 
wound and copied to the punch file, after which the job terminates. 



Data for execution 


^ Subprogram CDA 


^ Subprogram TEST2 

^ Subprogram TESTl 


^COPYBR(LGFILEl, PUNCHB) 
fREVaNDiLGFILEl) 


LGFILEl. 


^ COPYBR(LGFrLE2. PUNCHB) 


l' REWIND(LGFILE2) 


^ REWINDfLGFII.El) 


( COMPASS(B LG 11LE2) 
('C0MP*ASS(B=LG FlLEi) 


SAMPLE, T500, EC50, CM50000. 


Control 

Section 


6036P900A 


10-0 



/ 


In the following example, COMPASS is called from within a FORTRAN program. The source program 
follows the FORTRAN program in the same section. 

No parameters on the RUN card cause: 

1. Loading and execution of the RUN compiler 

2. Object program CM/^CM and ECS/tcM fields to be set 

3. Source decks on INPUT 

4. Listings to be written on OUTPUT 

5. Binary object programs to be written on LGO 

6. No cross reference list to be produced 
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The foilowing sample job deck illustrates how to assemble and use a system text overlay. 

TEXT, CM60000, T300. 

COMPASS(S=0, B=TEXT) 

COMPASS(G=TEXT) 

7/8/9 

IDENT TEXT 
STEXT 

• Contains definitions for 

system macros, micros, 
and symbols. 

i 

END 

7/8/9 

IDENT PROGRAM 
SST 

• 

, Defines symbols from TEXT 

Programs using definitions in TEXT 

« 

END 

6/7/8/9 
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LISTING FORMAT 


11 


This section describes assembly listing format. Control of the contents of the listing is described in 
section 4.11 Listing Control, and in section 10.1.2 COMPASS Control Statement. 


11.1 PAGE HEADING 

Each page of the assembly listing contains a title line and a subtitle line in the following format: 


title 

COMPASS Version 

date 

time 1 PAGE x 

subtitle 

sub-sub 
title 

block 

name 

symbol 

qual 



title 

date 


Up to 62 characters taken from the first TITLE pseudo instruction or from a 
TTL pseudo instruction or, in lieu of these, from the IDENT instruction 

Date of assembly 


time 
PAGE X 

subtitle 

sub-subtitle 


block name 
symbol qual 


Time of assembly in hours, minutes and seconds 

Page number of listing. Pagination begins with 1 for each END instruction 
unless the P option is selected on the COMPASS control card 

Up to 62 characters taken from second and subsequent TITLE pseudo 
instructions or a CTEXT pseudo instruction 

Up to 10 characters taken from the most recent EJECT, SPACE, TITLE, or 
TTL pseudo instruction or the location field of an ES or PS machine instruction. 
If the instruction that introduces the new sub-subtitle also causes a page eject, 
the instruction imnaediately follows the heading (assuming the C list option is 
also selected). 

Name of the block in use at beginning of page 

Qualifier in use (see QUAL pseudo instruction) at beginning of page 


11.2 HEADER INFORMATION 

The first page of the assembly listing for each subprogram contains a summary of binary control cards 
(optional), a list of all the blocks established for the subprogram, and lists of entry points and 
external symbols. 


n.2.1 BINARY CONTROL CARD SUMMARY 

A binary control card summary in the following format is generated for each IDENT instruction when the 
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COMPASS control card or the LIST instruction selects the B list option: 


ADDRESS 


LENGTH BINARY CONTROL CARDS. 


addrj 


^1 


binary cardj 


addrg 




binary cardg 


addr 

n 


binary card^^ 


binary cardj 


addr. 

^i 

Example: 


The binary card that caused generation of the binary for the overlay, partial 
binary, or subprogram. The list includes SEC, SEGMENT, and END instruc¬ 
tions. 

The origin address for the subprogram, overlay, or partial binary written out 
as a result of the binary card 

The length of the subprogram, overlay or partial binary 


anoRFss 

LENGTH 

PTNflRY 

rONT-?OL tapd? 

101 

271 

incNT 

rOMPaSE,LOVER 

^7? 

‘5241 

SFG 


'563'» 

1 24? 

5FG 


7n7^ 

414S 




'517'5 



?n4’7 

135? 

.SEG 


22011 


PMO 

COMPASS 
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11.2.2 BLOCK USAGE SUMMARY 


A block usage summary of the following format is generated in the assembly listing under 
control of the B list option: 


BLOCKS 

TYPE 

ADDRESS 

LENGTH 

name^ 


baddr^ 


name2 

*•2 

baddrg 

bfg 

namCj^ 


baddr 

bfn 


namej 


type 


baddr. 

1 


Name of the block used in the subprogram, as follows; 


PROGRAM* 


ABSOLUTE* 

LITERALS* 

other 


For a relocatable assembly, indicates the zero 
block. For an absolute assembly, the first 
PROGRAM* indicates the absolute block, the 
second indicates the default symbols block. 

Appears in a relocatable assembly only and 
indicates the use of an absolute block. 

Identifies the literals block. 

Identifiers a local, labeled common, or blank 
common block. 


The type of the block as follows: 

ABSOLUTE All addresses in the block are relative to absolute 

zero. For an absolute assembly, all blocks are 
ABSOLUTE. 


+ LOCAL Addresses in the block are relative to the origin 

assigned to block zero. The + is present for an 
ECS/LCM block. 

+ COMMON Addresses in the block are relative to the origin of 

the common block. The + is present for an ECS/ 
LCM block. 

Beginning address of the block according to type. 


length. 


Number of words in the block. 
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Examples: 


BLOr-KS 

T YPR 


length 

PPOGBflM* 

ftnsOLIITF 

n 

5415 

LTTFRflLB* 

flPSOUlTF 

541 F 

215 

rONTOOL 

flPSOLUTF 


1242 

PBruon 

abshlutp 

707': 

4145 

BUBB 

absolutt 

1 324? 

5175 

BUFFERS 

ABSOLUT'^ 

20437 

11140 


BLOCKS 

TYoe 

ADDRESS 

LENGTH 

ABSOLUTE* 

ABSOLUTE 

u 

62 

PROGRAM* 

LOCAL 

0 

35 

OATAi 

LOCAL 

35 

1 

LCM 

+LOCAL 

0 

5 

TABLE 

+L0CAL 

5 

5 

TABLE 

+COMMON 

a 

123 

TABLE 

local 

36 

1 

TABLE 

COMMON 

Q 

1 

// 

COMMON 

0 

lacQ 


11.2.3 ENTRY POINT LIST 

If the subprogram declares entry points, a list of entry point symbols in the following format follows the 
block usage summary. 


ENTRY POINTS. 

sym^^* +addrj^ +blockj^ 

sym * +addr +block 
« ^ ^ 


sym , ♦ +addr , 
n+1 n+1 

sym * +addr „ 
n+2 n+2 


+block , 
n+1 

+block „ 
n+2 


sym 

sym 


2n+l 

2n+2 


* +addr„ +block 

2n+l 

* +addr „+block 

2n+2 


2n+l 

2n+2 


sym * + addr +block 
n n n 


sym^^* +addr^_ +block 


2n 


2n 


sym„ * +addr„ +block„ 
3n 3n 3n 


Where n is one-third the number of entry points. The asterisk to the right of sym. is present if sym. 
is a conditional entry point (declared by ENTRYC). The + to the left of addr. is present if block, is ^ 
an ECS/LCM block. The + to the right of addr. is present if addr is relocatable. Block, is ^ 
blank or a common block name surrounded by slashes. ^ 


If the symbol is undefined, addr. is 
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Example: 


ENT'?Y POINTS. 


GNSPi 

1 345 + 

CALL 

72 + 

PEOROEB 

23^5+ 

SNAD2 

1352 + 

GOTO 

156 + 

RPF 

2 461 + 

SNaP3 

1357 + 

IF 

224 + 

POH 

2463 + 

JUMPVEC * 

Q+/JUNPVEC/ 

L A3EL 

372 + 

LCH + 

L + 

BEGIN 

u + 

READ 

435 + 

LCMB *+ 

1 a + 

BYTESI7 

6 

RECORD 

24+/nATA/ 




11.2.4 EXTERNAL SYMBOL LIST 

If external symbol references are declared in the subprogram, a list of the following format follows the 
list of entrj' point symbols: 

EXTERNAL SYMEOLS. 


symj^ 

synijj^j sym2„,i ’ * * 

®y™7n+l 

symg 

®y”in+2 


symg 

symn,3 


symn 

"y”^2n 



Where n is one-eighth the number of external symbols. 
Example: 


rXTFPNBL SYMBOL'^. 

TPMFG CONEXTT vn'^''oi '"cgoto rpr 


11.3 OCTAL AND SOURCE STATEMENT LiSTING 

The contents of the octal and source statement listing depends on the options selected. 
The list is 130 characters wide with fields asrigneu a.s shown in figure 11-1. 


60360900A 


11-.5 



Fissure 11-1. Format of Octal and Source Statement Listing 


Error Flags (amor flags indicating that errors of the type indicated have been detected on the 

source line or in a subsequent statement that is not listed. These flags are 
described more fully under Error Directory. Lines containing errors are always 
listed. 

Location 

Addresses The value of the location counter with leading zeros suppressed. If no code is 

generated or no location symbol is defined by the statement, this field is blank, 
if at the time the value is assigned, the value of the location counter differs from 
the value of the origin counter, an L precedes the address. 

Octal Code Lhe actual code generated by this statement. Depending on options selected, the 

listing shows just the first word or all words generated for data generation 
instructions. The field does not include NO instructions (46000g) packed for a 
force upper or zeros packed for a completed parcel on a VFD. A 24-bit PPU 
instruction is shown two words of data per line. 
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If the word contains an address, the octal code is flagged as follows: 


Negative relocatable address 
t Positive relocatable address 

C Common relocatable address 

X External address 


For a statement that does not generate code, this field is normally blank. 
Exceptions are as follows: 

For a LIT instruction the field contains the address of the first word of 
the litetals generated. 

For a {’UL instraetion, the iie!d contains the new beginning-of-commenis 
column number. 

For a symbol defined through SET, MAX, MIN, EQU, =, or MICCNT, 
this field contains the octal value of the symbol right justified with leading 
zeros suppressed. 

For an irit tructicn resuUir.g in a change of base, the notation b^r^br, is right 
justified in the field. b| indicates the old base and b 2 indicates the new base. 

For an instruction resulting in a change of code conversion, the notation 
Cj (—*02 is right justified in the field. Cj indicates the old code and C 2 
indicates the new code. 

For a DUP instruction, the field contains the repeat count. 


Source Code 
Sequence 


Source statement image Icolumns 1-72) 

Columns V3-90 of the card image or an identifier for an expansion of a definition 
operation as follows:: 


Macro 

Remote code 
Duplicated code 
Echoed code 
XT EXT 
OPDEF 


macro name 
♦rMT* 

*DUP* 

*ECHC* 
file name 

Operation field of opdef call, e. g., SBl 


The recursioa level ind-eih 1 in Jhe right liali ■>f the field. 
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Kxamplc 



COMPASS 

3.71210 - CYBER 70/ COMPREHENSIVE 

ASSEMBLER. 

COMPASS 3.71210 CB/20/71 16.25.44. 

PAGE 

82 

COMMON 

ANO UTILITY SUBROUTINES. 




ALC 




ALC - 

TABLE MANAGER ANO ALLOCATOR. 

COMPASS 

1605 




ALLOCATOR MILL HOVE TABLES TO ACQUIRE ROOM. ALSO MAY DUMP 

COMPASS 

1606 




INTERMEOIATE OR CROSS-REFFRtNCrs ONTO SCRATCH FILE. 

COM^^ASS 

1697 




ENTRY 

(AO) = TABLE INDEX. 

COMPASS 

1696 





<X1> = CHANGE (♦ OR -1 TO TABLE SI7E. 

COMPASS 

1690 




EXIT 

(X2) = ORIGIN OF TABLE. 

COMf’ASS 

17. L 





(X3) = NEH 

LENGTH OF TABLE. 

COMPASS 

17. 1 







COMPASS 

1 7 2 







COMf^ASS 

17.3 

5020003462 

ALCX 

SA2 

ORTGINS»A0 

RECLAIM VALUES FOR EXIT.REPLY 

COHf'ASi 

17 4 


5030003516 


SA3 

SIZES»A1 


COMPASS 

17,5 







COMPASS 

17.6 

5467 

0000000000 

ALC 

PS 


RETURN EXIT 

COMPASS 

17.7 

5470 

6120000034 

ALCl 

S32 

NTABLES 

PRESET INDEX REGISTERS 

COMi'ASS 

17:8 


5Q20Q03462 


SA2 

0R15INS*A9 

CURRENT ORIGIN 

COMMAS 5 

9 

5471 

54322 


SA3 

A2»92 

CURRENT LENGTH 

CO’ir AS' 

171. 


54421 


SA4 

A2*in 

NEXT TABLE ORIGIN 

C0‘*iASS 

1 ■’1 1 


36613 


1X6 

X1*X3 

NEM ST7E 

COMi’ftS'- 

1712 


37042 


1X0 

X4-X2 

TEST IF ROOM FOR EVPAMSION 

COM ‘ASS 

1 71 3 

5472 

37Q06 


IXJ 

X0-X6 


coM-'ar? 

1 n 4 


0330005474 


NS 

XJ fALC2 

JUMP TO RE-ALLOCATE CORc 

COM 'ASS 

1 7; 1 


54630 


SA6 

A3 

STORE NEH SIZE 

COMPASS 

1 716 

5473 

0400005466 


El 

ALCX 

FXIT 

COMPASS 

1 71 7 







COM-’Af" 

1 7l fl 



• 

MOVE TABLES. 


COM-'ASS 

1710 







COMPAS ' 

172': 

5474 

5120003172 

ALC2 

SA2 

SI7CORE 

SEE TF ENOUGH POOH 

cn-pAss 

1 721 


10411 


nx4 

XI 


roMiAss 

1722 


67721 


S37 

02-11 


CO-PAS*^ 

1713 

5475 

67771 

ALC3 

S37 

H7-B1 


C1M--SS': 

1 114 


5157003516 


SA5 

SI7ES»B7 



! 


36445 


1X4 

X4 ‘XS 



1 .’?'7 

5476 

0570005475 


N7 


LOOP 

r.GM.'Aicc 

1 :•’? 


513QCQ3345 


SA3 

PASS 


COM-'ASS 

1 7,'8 

54 7/ 

63730 


SJ7 

X3 


CCM-^asS 

l’2S 


37024 


IXO 

X2-X4 


COMPASS 

173 0 


63440 


ST4 

S57 

K4 

(fl4) = TOTAL LENGTH 

COMPASS 

17J1 




11.4 LITERALS 


When the I) list option has been selected, the assembly listing includes a listing of the literals block 
following the default symbols listing. Following each literal address is the octal contents of 
the word and n display code conversion of the contents of the word. 


Kxamples: 


CONTENT OF LITERfilS BLOCK. 


0111? 1 17h'=57r77S?mOiOOOOn 
oini?'’ ib<=-‘5nonionnnor!00or)on 
Oni?'' I''i0'‘-?3?''n in 705157676 

0ni?4 15040507111601 1(455?? 

010121 01?1?511?711504170 00 0 

0101?6 55??05?1?51122050400 

010127 oooooonoooooooooooon 

010170 ?0??170727011151010? 

010171 17???457nnn000000000 


0+.>>X 

Nr* 

77 

OFriMflL R 
EOUTRFn. 
PFnuTOfn 

PROGRAM AR 

OPT. 


CONTENT OF LITERALS BLOCK. 


73in 

0134 

1 

7X16 

7070 

♦ t 

7?t 7 

00^7 

G 

7 321 

Qonn 

7 3?1 

iipi 

A 

7 371 

onno 


732X 

0106 

FF 

7324 

1411 

LT 

7321 

240^ 

TP 

7326 

2201 

PA 

7327 

1423 

LS 
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11.5 DEFAULT SYMBOLS 


When the D list option is selet ted, a list of default symbols immediately precedes the literals block. 
Example: 

OE»^AUtT SYMBOLS OCFINED BY COMPASS 


ooQOoa X 

H^G= 


TAGt 

DOS ^ 

TAG? 


flnr 

rn546*» 

<; VM 


11.6 ASSEMBLER STATISTICS 

Assembler statistics are printed at f''e end o' fhe ccfsl and source statemciif 'isting or. the D list 
option is selected, following the default symbols. Information includes the following: 

Amount of storage used (octal) 

Number of source statements 
Number of symbols defined 
Number of invented symbols 
Number of symbol references 

Machine on which COMPASS executed and assembly time 
Number of errors encountered during assembly 

Number of lost references, that is, references to symbols that have been omitted from the 
symbolic reference table. 


11.7 ERROR DIRECTORY 

The assembly listing includes an error directory if any errors are detected during assembly. The 
directory begins a new page identified with the subtitle ERROR DIRECTORY. Each type of error that 
occurred is called out with a two-line message of the following format: 

X TYPE ERROR description 

OCCURRED ON PAGES p., . p^ 

Types and descriptions are given in Tables 11-1 and 11-2. Errors flagged with an alphabetic character 
are fatal. A fatal error causes suppression of binary output. Nonfatal warning flags are numeric; they 
are informative only. 
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TABLE 11-1. FATAL ERRORS 


Ilefinition 

ADDRESS FIELD BAD. 

Indicates any of a number of possible errors in a variable subfield entry. 
For example: 

CODE character not A, D, E, I, or * 

Symbol or name greater than 8 characters 

Expression does not reduce to one external term, relocatable terms do 
not cancel properly, instruction disallows register designators, 
instruction requires absolute expression, etc. 

Data error; 8 or 9 encountered in octal data, modifier not S, P, O, E, D, 
or B 

No data in variable field of LIT instruction 

No symbol following an =S or =X prefix 

Relative jump out of range (-31>r >31) on PPU instruction 

BASE character not O, M, D, or * 

Register illegal in CON instruction 

Unable to locate synonymous instruction for OPSYN or CPSYN. 

Micro count less than zero or greater than ten 
NOLABEL character not 1 
Negative relocation on ORG 

POS value less than 0 or greater than word size. 

Erroneous OPDEF reference 


DOUBLY DEFINED SYMBOL. THE FIRST DEFINITION HOLDS. 

Symbol previously defined or declared external 

ECHO, DUP, RMT, OR MACRO ILLEGALLY NESTED. 

Definition not wholly within next outer definition 

NUMBER OF ENTRIES EXCEEDS PERMISSIBLE AMOUNT. 

LIT generates more than 100 words 
Data missing or erroneous on XTEXT file 

More than 63 formal parameters and local names in macro definition 
More than 255 blocks 
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TABLE 11-1. FATAL ERRORS (cont'd) 


[Error 

Type 

1 

1 

Definition | 

I L 

liOCATION FIELD BAD, 

Required location field entry id erroneous I 

Format two macro definition has no substitutable parameters | 

N 

NEGATIVE RELOCATION ON ENTRY POINT. 

O 

OPERATION FIELD BAD. i 

Instruction ucreecsgniyabie, out of sequence (e.g., or PPU not in 

tirat srateni-'?rit arjsjp r r instruction is illegal for binan; or 

relational mnemonic oii IF statement is err-iineous. Location symbol 
begins beyond column two. | 

P 

I 

CONSULT LISTING FOR REASON BEHIND P-ERROR ! 

1 

User-generated error Hog lERR or ERR‘<x iuo-tmction' 

R 

DATA ORIGIN OUTSIDE BLOCK OR IN BLANK COMMON. 

i 

Range error | 

U 

UNDEFINED SYMBOL. VALUE ASSUMED 0. 

i 

Reference to a symbol that is not defined; for example, IF j 

statement line ' ount, OIS word count, unrecognizable attribute j 

on IF tdatement, i Jiti uno'efined qualifier 

V 

BIT COUNT ERKOli ON VFD ^MUST BE 0 F COUNT ^ 60). 1 

VFD field size erroneous 
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TABLE 11-2. INFORMATIVE ERRORS 


Error 

Type 

Description 

1 

2 

LOCATION SYMBOL BAD. SYMBOL NOT DEFINED. 

Location field entry erroneous. The instruction does not require an entry. 

ADDRESS ERROR ON SYMBOL DEFINITION 

Erroneous variable field entry. The location field symbol is not defined. 

3 

DUPLICATE MACRO DEFINITION. NEW ONE OVERRIDES. 

iVIacro, opdef, or synonymous operation redefines operation code 

4 

BAD FORMAL PARAMETER NAME IGNORED. 

Macro or ECHO formal parameter name repeated or illegal 

5 

CPU OPERATION SYNTAX INCORRECTLY SPECIFIED. 

OPDEF, CPOP, CPSYN, or PURGDEF specifies illegal syntax 

6 

LOCATION FIELD MEANINGLESS. 

Entry in location field is ignored 

7 

ADDRESS VALUE EXCEEDS FIELD SIZE, RESULT TRUNCATED. 

Value of expression exceeds size of destination field 

BSS address expression value is negative 

MICRO starting character position or character count is negative 

8 

MISSING OR EXTRA ADDRESS SUB FIELD. 

Variable subfield entry missii^ or superfluous 

9 

MICRO SUBSTITUTION ERROR. NO SUBSTITUTION 

Micro reference unrecognized 
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11.8 SYMBOLIC REFERENCE TABLE 


The assembler generates a sy nbolic reference table (figure 11-2) if the L list option is on at the end of 
assembly. The table is not complete if the option was turned off at any time during the assembly. The 
table lists symbols according to the qualifier, if any, under which they were defined. The global 
symbols are listed first. A new heading of the following form introduces each new list of qualified 
symbols. 


SYMBOL QUALIFIER = qualifier 

The qualifiers are in the order declared in the subprogram. Symbols are listed alphabetically. 

When symbol references are lost because table space has been exceeded, the subtitle line includes 
notification in the form n LOST REFERENCES. 


r 


Fine 


SYMBOLIC REFERENCE TABLE. 


symbol 


value 


symbol 

value 

block 


block 


page/line 

and/or 

address 


page/line 

and/or 

address 


bC 

CC 

:E 


page/line | 

and/or 

address 


page/line 

and/or 

address 


.L 


Figure 11-2. Fermat of Synibolic Rcfe^’ence Table 
Alphabetical list of symbols defined under the qualifier 

Absolute value of the symbol or the address assigned to this symbol relative to 
the block named 

K the symbol was defined by the SST pseudo instruction, block is the system 
text file or overlay name. Otherwise, this field is blank in an absolute assembly 
or, in a relocatable assembly, it contains the name of the block containing the 
symbol. 
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page/line From left to right and from top to bottom, a list of indices sequenced according 

to page number. Each index points to a statement containing references to the 
symbol or defining the symbol, 

address When the XREF pseudo (section 4.11. 8) has been used, the page line field contains 

the location counter address of the instruction containing the reference. Page 
and line numbers are optionally included with the address. 

flag Identifies page/line index to a statement that defines the symbol or uses it in an 

IF statement as follows: 

D Definition statement; EQU, =, SET, MAX, MIN, or MICCNT 
E ENTRY or ENTRYC pseudo instruction 
F Symbol used in conditional test 
L Symbol used in location field of the statement 
S Symbol used for storage 

X EXT pseudo instruction 


When XREF A is in effect, the table does not include the flags. 


Example: 
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CHARACTER SETS 


A 


NOTES 

1. The terms upper case and lower case apply only to the case conversions, and 
do not necessarily reflect any true case. 

2. When translating from display code to ASCII/EBCDIC the upper case equivalent 
character is taken. 

3. When translating from ASCIl/EBCDIC to display code, the upper case and lower 
case characters fold together to a single display code equivalent character. 

4. All ASCII and EBCDIC coders not listed are translated to displa> cede 55 ispaceU 

5. Where two display code graphics are shown for a single octal code, the leftmost 
graphic corresponds to the CDC 64~character set (system assembled with IP CSET 
set to C64.1), and the rightmost graphic corresponds to the CDC 64-character 
ASCII subset (system assembled with IP CSET set to C64.2). 

6. In a 63-characU.r set cyiaem, tlic display code for the : graphic is 63. The % 
character does not exist, and translations from ASCll/EBCDIC % or ENQ yield 

blank (55 ). The display co.le value 00 is undefined In 63-character set systems. 

8 

7. Twelve or more zero bits at the end of a 60-bit word are interpreted as an 
end-of-line mark rather than two colons. An end-of-line mark is converted to 
external BCD 1632 and Internal BCD 1672 by operating systems when writing 
7-track magnetic tape in even parity (coded) mode, and converted back to 0000 
when reading. 

8. This code Is clumged to 12 when on a ?-track magrictic tape is even 

parity (coded) mode, 

9. 11-0 and 11-8-2 are equivalent on input. The character wlli be pimched as 

11- 0 on output. 

10. 12-0 and 12-8-2 are equivalent on input. The character will be punched as 

12- 0 on output. 

11. 12-8-7 and 11-0 are equivalent on input. The character will be punched as 
12-8-7 on output. 

12. 12-8-4 and 12-0 are equivalent on !nnut. The character will be punched as 
12-8-4 on output. 

13. CODE pseudo selects 6~bit octal code as follows: 

A ASCII 

D Display Code (default) 

E External BCD 

I Internal BCD 
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A-1 


CODE D (default) 


CODE E 


i 1 


CODE I 


CODE A 

I 


llsplay Hollerith BCD ASCII EBCDIC 

Punch Upper Case Lower Case Upper Lower 

(026) 6-Blt 

Octal I Char. I 0^1 Hex. I Char. I Punch I Hex. I Char. I Punch Hex. I Char, I Hex. I Char. 


EBCDIC 

Upper Lower 



12-1 


21 41 

22 42 


25 45 

26 46 

27 47 

30 50 

31 51 

41 52 

42 53 

43 54 

44 55 

45 56 

46 57 

47 60 

50 61 

51 62 

62 63 

63 64 

64 65 

65 66 

66 67 

67 70 

70 71 

71 72 
00 20 
01 21 
02 22 


12 - 11-1 

12 - 11-2 

12-11-3 

12-11-4 

12-11-5 

12 - 11-6 

12-11-7 

12 - 11-8 

12-11-9 


12-11-9-8-1 


04 24 
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PODF 1*' 

CODE D (default) Y CODE . 

I I CODE A 

i i I 


I 

1 Display 

Hollerith 

BCD 




Ascn 





EBCDIC 


! Code 

Punch 




H>per Case 



Lower Case 

Upper 

Lower 

! 


(026) 



6-Blt 










, i 

^ Octal 

Char. 


Ext. 

Int. 

Octal 

He.x. 

1 Char. 

Punch 

jHex. 

Char. 

j Punch 

Hex. 

Char. 

Hex. 

Cha/'. 

(§ 



® 

® 



1 

U- ' 



i 





40 

5 

5 

05 

05 

25 

35 

; 5 

5 

15 

NAK 

9-8-5 

F5 

5 

8D 

NAK 

41 

6 

6 

06 

06 

26 

36 

i 6 

6 

16 

SYN 

9-2 

F6 

6 

32 

SYK 

! 42 

7 

7 

07 

07 

27 

37 

7 

7 

17 

ETB 

0-9-6 

F7 

7 

26 

ET'i : 

43 

8 

8 

10 

10 

30 

38 

8 

8 

18 

CAN 

11-9-8 

F8 

8 

18 

CAN 

1 44 

9 

9 

11 

11 

31 

39 

9 

' 

9 

19 

EM 

11-9-8-1 

F9 

9 

19 

EM 

1 45 

+ 

12 

60 

20 

13 

2B 

+• 

12-8-6 

OB 

VT 

12-9-8-3 

4E 

+ 

OB 

VT 

! 46 

- 

11 

40 

40 

15 

2D 


11 

OD 

CP. 

12-9-8-5 

; 60 

i 


OD 

CR 

^ 47 

* 

11-8-4 

34 

.. 

H 

M 

-■7 

n A- 4 

Oa 

LF 

<'-9-6 




■.S' ; 

50 

/ 

0-1 

21 

61 

17 

2F 

/ 

0-1 

OF 

SI 

12-9-8-7 

61 

/ 

OF 

SI 

51 

( 

0-8-4 

34 

74 

10 

28 

< 

12-8-5 

08 

BS 

11-9-6 

4D 

( 

16 

BS 

52 

) 

12-8-4 

74 

34 

11 

29 

) 

11-8-5 

09 

HT 

12-9-5 

5D 

) 

OS 

HT j 

53 

$ 

11-8-3 

53 

53 

04 

24 

$ 

11-8-3 

04 

EOT 

9-7 

5B 

$ 

37 

EOT 

1 54 

= 

8-3 

IS 

1.3 

35 

sn 

- 

8-6 

ID 

GS 

1X-9-8-S 

7E 

= 

ID 

IGS 

! 55 

1 

space 

space 

20 

60 

00 

26 

Space 

Space 

00 

NUL 

12-0-9-8-1 

40 

space 

00 

NUL 

‘ 56 

» 

0-8-3 

33 

73 

14 

2C 

* 

0-8-3 

OC 

FF 

12-9-8-4 

6B 

* 

OC 

FF 

i 57 

- #® 

12-8-3 

73 

33 

16 

2E 


12-8-8 

OE 

SO 

12-9-8-6 

4B 


OE 

SO 

1 60 

0-8-6 

36 

76 

03 

23 

# 

8-3 

OS 

ETX 

12-9-3 

7B 

# 

03 

ETX 

61 

I 

8-7 

17 

17 

73 

5B 

j 

12-8-2 

1C 

FS 

11-9-8-4 

4A 


1C 

IFS 

62 

Js) 

0-8-2 

32 

72 

75 

5D 

I 

11-8-2 

01 

SOH 

12-9-1 

5A 

! 

01 

SOH 

63 

8-6 

16 

16 

05 1 

25 

% 

0-8-4 

05 

ENQ 

0-9-8-5 

6C 

% 

2D 

ENC 

64 


8-4 

14 

14 

02 ! 

22 

’’ 

S-7 

02 

STX 

12-9-2 

7F 

1* 

02 

STX 1 

65 

66 

r- 

V 

0-8-5 

11-0® 

35 

52 

7*; 

?? - 
ui ; 

> r 


... •’0 

7F 

7D 

DEL 

i 

1 

12-9-7 

liO 

60 

4F 


07 

DO 

DEL 1 
i 1 

1 

67 

A & 

0-8-7 

37 

77 

06 

26 

St 

12 

06 

ACK 

0-9-8-6 

50 

& 

2E 

ACK 

70 

f - 

11-8-5 

55 

55 

07 ! 

27 

• ; 

8-5 

07 

BEL 

0-9-8-7 

7D 

t 

2F 

BEL 1 

71 

1 ? 

11-8-6 

56 

56 

37 i 

3F 

? 

0-8-7 

IF 

US 

11-9-8-7 

6F 

? 

IF 

lUS 

72 

< 

12-0® 

72 

32 

34 I 

3C 

< ! 

12-8-4® 

7B 

( 

12-0 

4C 

< 

CO 

1 

73 

> 

11-8-7 

57 

57 

36 ' 

3E 

1 

0-8-6 

IE 

RF 

11-9-8-6 

6E 

> 

IE 

IBS 

74 

< @ 

8-5 

15 

Ic 

40 ■ 

40 


8"4 

80 ' 

X 

8-i 

7C 

§ 

78 

i 

i 

75 

> \ 

12-8-5 

75 

35 

74 i 

5C 

‘X j 

0-8-2 j 

7C 1 

1 

12-11 

EO 

S 

6A 

i 

76 

~i A 

12-8-6 

76 

36 

76 ! 

i 

5E 

A 1 

11-8-7 

7E 

fV 

11-0-1 

5F 

-j 

A1 

rv 

77 


12-8-7 

77 

37 

. 1 
_L 

SB 

i 

> i 

1 

_L 

ll-R-6 

IB 

ESC 

0-9-7 

6E 

i 

27 

ESC 
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HEXADECIMAL-OCTAL CONVERSION TABLE 



First 

0 

Hexac 

1 

lecimal 

2 

Digit 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

Second 0 

000 

020 

040 

060 

100 

120 

140 

160 

200 

220 

240 

260 

300 

320 

340 

360 

Digit 1 

001 

021 

041 

061 

101 

121 

141 

161 

201 

221 

241 

261 

301 

321 

341 

361 

2 

002 

022 

042 

062 

102 

122 

142 

162 

202 

222 

242 

262 

302 

322 

342 

362 

3 

003 

023 

043 

063 

103 

123 

143 

163 

203 

223 

243 

263 

303 

323 

343 

363 

4 

004 

024 

044 

064 

104 

124 

144 

164 

204 

224 

244 

264 

304 

324 

344 

364 

5 

005 

025 

045 

065 

105 

125 

145 

165 

205 

225 

245 

265 

305 

325 

345 

365 

6 

006 

026 

046 

066 

106 

126 

146 

166 

206 

226 

246 

266 

306 

326 

346 

366 

7 

007 

027 

047 

067 

107 

127 

147 

167 

207 

227 

247 

267 

307 

327 

347 

367 

8 

010 

030 

050 

070 

110 

130 

150 

170 

210 

230 

250 

270 

310 

330 

350 

370 

9 

Oil 

031 

051 

071 

111 

131 

151 

171 

211 

231 

251 

271 

311 

331 

351 

371 

A 

012 

032 

052 

072 

112 

132 

152 

172 

212 

232 

252 

272 

312 

332 

352 

372 

8 

013 

033 

053 

073 

113 

133 

153 

173 

213 

233 

253 

273 

313 

333 

353 

373 

C 

014 

034 

054 

074 

114 

134 

154 

174 

214 

234 

254 

274 

314 

334 

354 

374 

D 

015 

035 

055 

075 

115 

135 

155 

175 

215 

235 

255 

275 

315 

335 

355 

375 

E 

016 

036 

056 

076 

116 

136 

156 

176 

216 

236 

256 

276 

316 

336 

356 

376 

F 

017 

037 

057 

077 

117 

137 

157 

177 

217 

237 

257 

277 

317 

337 

357 

377 

Octal 

000 - 

037 

040 - 

077 

100 - 

137 

140 - 

177 

200 - 

237 

240 - 

277 

300- 

337 

340 - 

377 
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USE OF RECORD MANAGER FOR ASSEMBLY-TIME I/O B 


COMPASS 3 under SCOPE 2 uses the Record Manager for all of its I/O operations. Under SCOPE 3,4/ 
KRONOS 2.1 use of Record Manager for assembly-time I/O is an installation option.t 

Thus, COMPASS 3 can read and write files with a variety of external formats. For each of the files 
used by COMPASS, the default format, and the combinations of file format description parameters that 
may be specified in FILE control cards to override the defaults, are given below. 


Main Source Input File 

The main source input file may be a normal source input file or a compressed compile file; COMPASS 
determines which it is by inspecting the data in the file. A normal source input file is as follows: 


System 

File Organization (FO) 

Block Type (BT) 

Maximum Block Length (MBL) 
Record Type (RT) 

Maximum Record Length (MRL) 
Conversion Mode (CM) 

Label Type (LT) 


SCOPE 3.4/'KRONOS 2.1 
sequential (SQ) 
constant (C) 

5120 chars, 
zero byte (Z) 

100 chars. 

YES 

A';y 


SCOPE 2 
sequential (SQ) 
unblocked 
none 

control word (W) 
100 chars. 

NO 

unlabeled (IIL) 


tNot implemented in SCOPE 3.4/KRONOS 2.1 
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The permitted formats are as follows (X=allowed, -=not allowed): 


Block 

Record Type 

Type 

B 

D 

F 

R 

S 

T 

U 

w 

z 

C 

- 

- 

X 

- 

- 

- 

- 

X 

X 

E 

- 

- 

- 

- 

- 

- 

- 

- 

- 

I 

- 

- 

- 


- 

- 

- 

X 

- 

K 

- 

- 

- 

- 

- 

- 

- 

- 

- 


File Organization (FO) must be sequential (SQ). 

Maximum Block Length (MBL) must not exceed 5120 characters. 

Maximum Record Length (MRL) must not exceed 160 characters. 

Label Type (LT) may be any value supported by the curating system. 

Although the maximum record length may be as lai^e as 160 characters, only the first 90 characters 
of each record are reproduced in the listing output files. 

If the file is a compressed compile file (written by UPDATE in X mode or MODIFYt in A mode), COMPASS 
sets the file format description parameters as follows; 

SCOPE 3.4/KRONOS 2,1 

Block Type (BT) = constant (C), Maximum Block Length (MBL) = 5120 characters. 

Record Type (RT) = undefined (U), Maximum Record Length (MRL) = 180 characters. 

Conversion Mode (CM) = NO. 

SCOPE 2 

Resembles normal input; however, MRL = 5120 characters. 


tMODIFY is not available under SCOPE 2 
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Listing Output Files 


The default format depends cu the type of system with which COMPASS is used, as follows: 


System 


SCOPE 3.4/KRONOS 2,1 


File Organization (FC) 

Block Type (BT) 

Maximum Block Length (MBL) 
Record Type (RT) 

Maximum Record Length (MRL) 
Conversion Mode (CM) 

Label Type (LT) 


aequenlial (SQ) 
constant (C) 
5120 chars, 
zero byte (Z) 
137 chars. 

YES 

AMY 


The permitted formats are as follows (X=aUowed, -=not allowed): 


SCOPE 2 

sequential (!:?Q} 

unblocked 

none 

control word (W) 
137 chars. 

NO 

Lciabeled (IjL: 


Block 

Record I’ype 

Type 

B 

D F P S 

T F W 

z 

C 

E 

I 

K 

- 

X 

X 

X 

- 

_ _ _ _ 

- - X 

- 


File Organization (FO) must be sequential (SQ). 

Maximum Block Length (MBL; ir.asi not exceea 5120 characters. 
Maximum Record Length (MRL) must not exceed 137 characters. 
Label Type (LT) may be any value supported by the operating system. 
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Binaiy Output File 


FILE control statements can be used to specify the format of binary output files for any of 
the operating systems, such that a program can be assembled on one system and the object 
program executed under a different system If so desired. 


File Characteristics 


SCOPE 3,4/KRONOS 2.1 SCOPE 2 


File Organization (FO) 

Block Type (BT) 

Maximum Block Length (MBL) 
Record Type (RT) 

Maximum Record Length (MRL) 
Conversion Mode (CM) 

Label Type (LT) 


sequential (SQ) 

constant (C) 

5120 chars. 

short block (S) 

none 

NO 

ANY 


sequential (SQ) 

unblocked 

none 

control word (W) 
1,310,710 chars. 
NO 

Unlabeled (UL) 


Both formats are allowed under all systems; the values shown above are the defaults for 
each system. No other formats are allowed, except that the label type (LT) may be any value 
supported by the operating system used for assembly. 


System Text Input Files 


A user library file designated by an S parameter on the COMPASS control card must have the standard 
library file format for the system on which COMPASS is being used. COMPASS uses the operating 
system overlay loader to access these files. 

For a sequential binary (non-library) file designated by a G parameter on the COMPASS control card, 
the default and permitted formats are the same as those given above for the COMPASS binary output 
file. 


XTEXT Input Files 


A file read by COMPASS when processing an XTEXT pseudo instruction may have any of several formats. 
COMPASS determines the file format (a) by whether the XTEXT pseudo instruction variable field is 
empty and (b) by inspecting the data in the file. 

If the variable field is empty, the File Organization (FO) must be sequential (SQ). COMPASS rewinds 
the file and reads until end of section or a COMPASS END statement is encountered, whichever comes 
first. The default and permitted formats are the same as those given above for the main source input 
file. 
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If the X TEXT variable field is non-empt>', the file organizaticm may be any of three non-standard types: 

Record Indexed with : ame index 

6000 SCOPE 3.3 style random file with name index 

UPDATE or MODIFYt randons pr-ograin file 

In each case, COMPASS sets the file format description parameters to the appropriate values; no FILE 
control card is needed. 

The record indexed file organization is actually the word addressable (WA) file organization with a set 
of format conventions superimposed on it. Such a file can be created by a FORTRAN program using the 
library subroutines OPENMS, STINDX, WRITMS, and CLOSMS with a name index, or by a COBOL pro¬ 
gram specifying ORGANIZATION IS STANDARD, SYMBOLIC KEY IS data-name. When COMPASS de¬ 
tects such a file, it sets the file format description parameters as follows: 


File Organization (FO) = word addressable (W A;. 

Block Type (BT) = constant (C) for SCOPE 3.4/KRONOS 2.1 or unblocked for SCOPE 2; Maximum Bloc k 
Length (MBL) = 5120 chars. 

Record Type (RT) = control word (W), Maximum Record Length (MRL) = 160 chars. 

Conversion Mcxle (CM) = NO 

COMPASS positions the file at the record pointed to by the index entry containing the name given in the 
XTEXT statement variable field, and then reads rec'srds sequentially until end of section or a COMPASF 
END statement is encountered, whichever comes first. 

The 6000 SCOPE 3.3 style random file with name index is permitted for compatibility with previous 
versions of COMPASS. When COMPASS detects such a file, it searches the file index and positions the 
file at the beginning of the specified section. The default and permitted formats for the section are the 
same as those given above for tlu- main source input file, except that File Organization (FO) = word 
addressable (WA) and Block Ty'pe (BT) = constant iC). Such files cannot be used with SCOPE 2. 

An UPDATE or MODIFYt random rr< grsm Mie is processed in the same w'ay as by COMPASS 2. 

The name in the variable field of the XTEXT statement must be the name of a common deck. WTien 
COMPASS detects such a file, it sets the file format description parameters as follows (no FILE control 
card is needed); 

File Organization (FO) = word addressable (WA). 


tMODIFY is not available under SCOPE 2. 
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I SCOPE 3.4/KRONOS 2.1; 

Block Type (BT) = constant (C), Maximum Block Length (MBL) = 5120 characters 
Record Type (RT) = undefined (U), Maximum Record Lei^th (MRL) = 180 characters 

Conversion Mode (CM) = NO. 


SCOPE 2: 


Block Type (BT) = unblocked 

Record Type (RT) = control word (W), Maximum Record Length (MRL) = 5120 characters 
Conversion Mode (CM) = NO 


COMPASS positions the file at the first record of the designated section (common deck). 

active record (the +COMDECK card) is skipped. COMPASS then reads records sequen la y, g g 

SSvrrecords. until end of section on a COMPASS END statement is encountered, whichever comes 

first. 


Scratch Files 


COMPASS uses two scratch files named 
Regardless of what may be specified by 
parameters for these files as follows: 


ZZZZZRL and ZZZZZRM, when table storage space overflows. 
FILE control cards, COMPASS sets the file format description 


File Organization (FO) = sequential (SQ). 
Conversion Mode (CM) = NO, 


For file ZZZZZRL : 

Block Type (BT) = constant (C) for SCOPE 3.4/KRONOS 2.1 or unblocked for SCOPE 2, 
Maximum Block Length 5120 characters. 

Record Type (RT) = undefined (U) Maximum Record Length = 2550 chars. 

For file ZZZZZRM: 

Block Type (BT) = constant (C), Maximum Block Length = 5120 characters 
Record Type (RT) = SCOPE logical (S), no Maximum Record Length 
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MODIF'^: Input 


Although the S 3 rmbolic prograii library maintenance program MODIFY is not included in the operating 
systems with which COMPASS 3 is released, provision for input from MODIFY is retained for COM¬ 
PASS 2 compatibility. Thus, the source input file may be a compressed compile file written by MODIFY 
in A mode, and (except with SCOPE an XTEXT pseudo instruction with a non-blank variable field can 
refer to a common deck in a ?IODIFY randosn program library. In each case, tise file format descrip¬ 
tion parameters are forced by COMPASS and are the same as for an UPDATE compressed compile file 
and an UPDATE random program library. 
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BINARY CARD FORMATS 


C 


Column 1 


7.8.9 

6.7.9 

6 . 7 . 8.9 

7.9 

7 and 9 not both in column 1 


End of section 
End of partition 
End of information 
Binary card 
Coded card 



1 

2 

3 

4 

5 







12 














11 
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1 

o 

u 

o 










1 


2 

'O 

o 

3 








__1 



c 

X 

3 


C 







•o 


£ 

4 


s 









a> 


0) 

5 


3 

CQ 









s 


c 

4) 

6 


O 

0) 

XI 









C 

TJ 

Ui 

3 

o- 

1 

7 


u 










e$ 

O 

8 









I 



i 

9 









- .. _ 

i 

J 



J 


A binary card can contain up to 15 60-bit CP(J words starting at column 3. Column 1 also contains 
a count of 60-bit words in rows 0, 1. 2, and ;iplus a check indicator in row 4. If row 4 of column 1 is 
zero, column 2 is used as a checksum for the card on input; if row 4 is one, no check is performed on 
input. 

Column 78 of a binary card is not used, znd ooiurncs . 9 and 80 contain a binary serial nuirkbsr. If a 
section is punched, each card han a ckm ks’:n- vs, < ; bunn 2 and a serial number in columcs 79 and 80, 

which sequences it within the logical recoid. 


Coded cards are translated on input from Hollerith to display code, and packed 10 columns per CPU 
word. For SCOPE 3.4, Z format, a CPU word with a lowest byte of zero marks the end of a coded card 
(it is a coded record), and the full length of the card is not stored if it has trailing blanks. A compact 
form is thereby produced if coded cards are transferred to another device. 
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HINTS ON USING COMPASS 


D 


1. Within a macro definition: 

a. Use comment cards having ♦ ia column one. These are not saved whereas other types of 
comments are saved. 

b. Whenever possible minimize the number of lines of code. 

c. IRP is faster than either ECHO or DUP. 

d. Use the substitutable pararusteT ilaga ;A, :B, etc., for macros to avoid a second line. 

e. Within macros, use F'-iOf’ a? e-o. Instead of local symbols. 

f. If possible, avoid recursive macro struecure jo increase assembly speed. 

g. If a macro call is the cause of an ert^jr, direct Ml list output to a file other than OUTPUT 
(L=filename) to obtain a list of cIk i rrc-.eo’as macro call with the error listing. 

" In IF sequences: 

a. Use line counts rather chan ENUii u- cenninate sequences. 

b. Use SKIP rather than !FP1‘ t:> sW; code. 

j. Micros: 

a. Micro replacement is time consuming. 

b. Avoid using local symbols for micros 

c. Use / ^ for a null substituti. a. 

4. Minimize SYSTEXT size. 

5. To reduce core requirements, use SEG cards in .absolute programs. 

6. Use NOREF for symbols for wtiieli Gsnr.g is noi required. 

7. Use QUAL for all overlays. 
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DAYFILE MESSAGES 



The dayfile messages that can be issii-ed by C oy-PAiSS are listed below, with an explanation ior each. 


ASSEMBLING xxxxxxx 

This message is displayed at the system operator's console only; it is not written lO the dayfile. 
COMPASS updates the display whenever it processes an IDENT statement with a non-blank variable field. 


ASSEMBLY ABORTED • 


This message can occur only when COMPASS is used on a CYBER 70/model 72, 73, or 74, and onl\ 
when the job has an ECS field lengo fv .. i? c tse, COMPASS may store some of its internal tables 
in ECS, and issues the above mes&:ige .arai alioi ts the job) when an ECS error persists through four 
attempts to read the data. For the CVBER 70/mode! 70, LCM errors are handled by the operating 
svstem. 


ASSEMBLY ABORTED - vrs Y!t; F EEC 

This message can occur only when COMPASS is us^d oh a CYBER 70/model 72. 73, or 74, and only whrn 
the job has an ECS field length. In tni.s raso, .. r t.M P.ASS may store some of its interna! tables in ECS, 
and issues the above message (and aborsE the job) whe n an errtir occurs in writing data to EC S; no retry 
attempt is made. For the CYB’.Il 70 modol 70, ECM errors are handled by the ojicrating systtmi. 


ASSEMBLY ABORTED - PASS n '! AP' 1 
OVERFLOW ASSEMBTdNG xvxv.w 

An irrecoverable table overflow ctindition ha;- t ccurred in assembly pass n (I or 2) while processing the 
indicated program. COMPASS niltK iue? men.uprice dynamically to all of its internal laliles, so that 
when one overflows, all do. Wheri the cabls-S (i</ noi idl fit in the availabie Sf M sp.icc, C O.Ml .hSS 
stores some of them in the job’s LCS/LC M i.t id length (if any) and .some others go to mass storage 
scratch files. COMPASS issues the above raessage, md aborts the job, when insuflicient SCM exists nlte 
all such possibilities have been e.xiiagEi' 1. 
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ASSEIMBI.Y COMPLETE. nniinnnB SCM USED, 
xxxx.xxx CPU SECONDS ASSEMBLY TIME. 

COMPASS issues this message when it has completed processing of all source programs on the input file 
and did not detect any fatal errors, nnnnnn is the octal number of SCM words needed; i.e. , the minimum 
field length needed to perform the assemblies successfully. It may be larger than the actual field length; 
in this case, it is the minimum field length needed to avoid lost references. The second line, which can 
be suppressed by an installation parameter, gives the total central processor time used by COMPASS, in 
seconds to three decimal places. 


ASSEMBLY ERRORS. nnnnnnB SCM USED, 
xxxx.xxx CPU SECONDS ASSEMBLY TIME. 

COMPASS issues this message when it has completed processing of all source programs on the input file 
and detected at least one fatal error. If the A option was specified on the COMPASS control card, 
COMPASS aborts the job after issuing this message, nnnnnn and the second line are as in the ASSEMBLY 
COMPLE'FE message. 


BAD CONTROL CARD ARGUMENT - xx 

The COMPASS control card contains an unrecognized or invalid argument. The offending argument is 
named in the message. See Chapter 10 for details. 


CANT IX)AD COMP2$ 

The operating system loader reported a fatal error when COMPASS attempted to load its primary overlay. 
This message should be preceded by an explanatory message from the loader. 


COMPASS NEEDS AT LEAST nnnnnB SCM. 

The job's SCM field length is too small for COMPASS, nnnnnn is the octal number of words needed by 
COMPASS belore it can begin processing. This can vary depending on the version of COMPASS used and 
the li.siing and !)inary output options specified on the control card. This is an absolute minimum, and 
does not include whatever space may be required for system text, local macro and micro definitions, etc. 


nnnnnnnnn ERRORS IN xxxxxxx 

COMPASS issues this message for each source program in which fatal errors are detected. 
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roENT CARD MISSING. 


COMPASS issues this messaf 3 for each source program in which an END statement is encountered 
before an IDENT statement is found. This is a fatal error. 


IMPROPER SYSTEM TEXT FORMA ; 

BAD SYSTEM TEXT - x-yyj-yyj.v/z^^zazKz 

A system text overlay does not have the internal format required by this version of COMPASS. This sr ly 
be caused by a system error. COMPASS ignores the bad overlay but does not abort the job. The 
second line identifies the offending overlay in liie same form in which it is specified in the COMP.ASS c. n- 
trol card; x=yyy 3 iyyy/zzzzzzz may be any of the follow ing: 

G=filenam 
G=filenam/overlay 
S=overIay 
S=library/overlay 


INPUT FILE EMPTY OR MISPOSi i P.NFD, 


COMPASS encountered end of data wr.eu R att(?mua-d to read the first line from the source input file. 
After issuing this message, COMPASS reiterates '‘n END card which in turn causes the IDENI CARD 
MISSING message and a fatal error. 


INSUFFICIENT STORAGE FOR SYSTEM TKXTf 
BAD SYSTEM TEXT - x~yyyyyyy ■ zzzzzz? 

COMPASS issues this message, but does not abor‘ the job, when an irrecoverable table overflow occur.s 
during system text loading, before the as sen begun. The second line identifies the system 

text being loaded at the time. A '0^ ' i ii vr. die job's SCM field length may be needed. 


nnnnnnnnn LOST REFERENCES iP xx.k.''xvx 

COMPASS issues this message for iMch rout program whose symbolic cross-reference table does not 
fit in the job's SCM field length lot r or Pag yax; bemre it is printed. Rather than aborting the job, 
COMPASS discards some of the refereuces. The ASSEMBLY COMPLETFJ message gives the field 
length needed to avoid lost references. 
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MORE THAN? SYSTEM TEXTS SPECIFIED. 


COMPASS issues this message, and aborts the job, when the G and S parameters on the COMPASS 
control card specify a total of more than seven system text overlays. 


NO CONTROL CARD TERMINATOR. 

COMPASS read continuation control cards and encountered end of section before finding a ) or . not in 
a $-delimited string. This is not a fatal error. 


RECURSION DEPTH EXCEEDED 400. 

COMPASS maintains a push-down stack for source input control, with one entry for each active DUP 
ECHO, HERE, XTEXT, or macro call. The maximum depth of this stack is set by an Installation 
parameter; it is 400 in the released system. WTien this limit is exceeded, COMPASS sets a fatal error 
and clears the stack (so that the next statement will be read from the source input file) but does not 
abort the job. This is usually caused by a source program error in which a macro calls itself indefinitely. 


SYSTEM TEXT NOT FOUND. 

BAD SYSTEM TEXT - x=yyyyyyy/zzzzzzz 

COMPASS issues this message, but does not abort the job, when it cannot load the system text overlay 
identified in the second line. For an overlay loaded from a library (S parameter), this message should 
be preceded by an explanatory message from the operating system loader. For an overlay loaded from 
non-library file (G parameter), COMPASS could not find the overlay on the file. 


nnnnnnnnn WARNING MESSAGES IN xxxxxxx 

COMPASS issues this message for each source program in which non-fatal errors are detected. 
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INDEX 


A abort mode 10-3 
A code option 4-26 
A error 11-10 
A list option 4-78 
A reference table option 4-85 
A register 

description 8-8 
designators 2-8 
setting 8-46 
ABS attribute 4-71 
ABS pseudo 

description 4-6 

example 4-4,7,14,15,17,18,50 
first statement group 4-2 
Absolute block 

absolute program 3-S 
description 3-2 
establishment 4-36 
relocatable program 3-6 
using 4-32,36 
Absolute program 
declaration 4-6 
structure 3-8 
Absolute text 3-6 
ACN instruction 9-22 ' 

ACCOUNT card, KRONOS 10-7 
ADC instruction 

arithmetic function 9-4 
description 9-9 
example 2-22,9-9 
ADD Instruction 

arithmetic function 9-4 
description 9-13 
Add unit 

floating point 8-4,7,37 
long 8-3 

Address modes, PPU 9-1 
Address 

absolute 4-4 
direct 9-13 
entry point 4-4,5,49 
external 4-6,9,10,50 
indexed 9-15 
indirect 9-14 


Di instruction 

arithmetic function 9-4 
description 9-14 
ADM instruction 

arithmetic function 9-4 
description 9-15 
ADN instruction 

arithmetic function 9-4 
description 9-8 
AJM instruction 9-17 
aOD instruction 

description 9-13 
replace function 9-5 
AOI instruction 

description 9-14 
replace function u-S 
AOM Instruction 

description 9-15 
replace function 9-5 
Arithmetic functions, PPU 9-4 
Arithmetic shift 8-32,34 
Arrow 

parameter separator 5-8,13 
special character 2-4 
ASCII code 

character set A-1 
option 4-26 
.’.ssenibler 1-1 

core requirements 1-3; 10-2 
statistics 4-78; 11-9 
Assembly envdronment test 4-64 
' fi'^embly listing 

detailed description 11-1 
general description 4-78 
generation 1 -4 
Assembly, remote c;jde 5-3 
.'.ssemDly time 11-9 
Asterisk 

BASE instruction 4-24 
element operator 2-24 
first column 2-1,2 
local symbol separator 5-S2 
location counter 2-9; 3-5 
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parameter separator 5-8,13,16,25,28 
special element 2-9,23; 3-5 
USE instruction 4-32 
USELCM instruction 4-34 
Attribute, symbol 2-6 
Attribute test 4-71 
AXi instruction 8-32,34 


Bbase 2-18,19; 4-23 
B binary mode 10-3 
B list option 4-79 
B reference table option 4-85 
Bl=l or B7=l pseudo instruction 
description 4-30 
effect on R* 4-59 
example 4-60 
illegal for PPU 4-9,10 
B register 

conditional jumps 8-26 n 
contents of Bl, B7 4-30 
description 8-8 
designators 2-8 
setting 8-48 
Base, assembly 4-23 

COL column count 4-31 
DIS word count 4-53 
DUP count 5-6 
ECHO count 5-7 

line count 4-64,66,67,68,69,72,73,75 
micro count 7-2,4,5 
numeric value 2-17 
overlay level numbers 4-4 
PPU number 4-4 ' 

REP counts 4-61 
setting through BASE 4-23 
SPACE line count 4-81 
string count 2-13 
VFD count 4-57 
BASE micro 7-6 
BASE pseudo 

description 4-23 
example 4-14,21,25,53,55 
permissible anywhere 4-2 
Binary control statements 4-79, 11-1 


Binary mode 10-3 

Binary output generation 1-4; 3-8,11,13,15; 10-3 

Binary write 3-8 

Blank 

compressed 5-1 
embedded 2-1 
expression terminator 2-2 
name terminator 2-5 
operation field 2-1 
parameter separator 5-8,13 
statement terminator 2-1 
string terminator 2-14 
use in character data 2-14 
variable field 2-2,4; 3-7 
Blank card 4-81 
Blank common 
CM 4-32 
description 3-3 
ECS 4-34 

establishment 4-32,34 
example 4-39 
LCM 4-34 
SCM 4-32 
Blank fill 2-15 
DIS 4-53 

Blank operation field 4-51 
Block copy instruction 8-14 
Block group 3-1,11,13,15,17 
Block group listing 11-3 
Block 

absolute 3-2; 4-32,36 
blank common 3-3; 4-32,34 
labeled common 3-2; 4-32 
literals 2-11; 3-2,6,7,9,11,12,14,16 
local 3-2; 4-32 
maximum number 3-1; 4-32 
origin assigned 1-3; 3-6,8 
subprogram 3-1 

used for definition operation 5-2 
user established 3-2; 4-32,34 
zero 3-2, 4-32,34 
Block name 4-32, 34 
Block name listed 11-1 
Block origin 1-3; 3-6 
Block usage summary 11-3 
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Booleaa unit 

description 8-4,7 
instructions 8-28,29,3ft, 31,36, 37 
Branch instructions 

CPU 8-11,13,16,23,26 
PPU 9-5 
Branch unit 

description 8-4 

instructions 8-11,13,16,23,24,26 
BSS pseudo 

description 4-39 

effect on origin counter 3-3 

example 4-4,10,17,29,30, 35, 3?,39,41; 

5-22,33 

force upper 3-5 
BSSZ pseudo 

description 4-51 
dumped by SEGMEN J' 4-16 
example 2-20; 5-34,36 
force upper 3-5 
BXI instruction 8-28,29,30,31 
Byte, guaranteed zero 2-15; 4-54 


C hardware feature code 4 8 
C list option 4-79 
C on octal listing 11-7 
Call 

equivalenced macro 5-25 
macro 5-18 
opdef 5-30 
CC instruction 8-54 
Central processor unit 

functional units 8-4,7 
instructions 8-1 
registers 8-8 
Channel buffer instruction 
read status 8-22 
reset input 8-19 
reset output 8-21 
CHAR 

define other character 4-25 
Character codes A-1 
Character data 2-14 

code conversion 4-26 
evaluation 2-27 
examples 2-12,16 


CMU 8-51 
Code 

CPU operation 6-8; 8-1 
duplication 5-6 
Code other 4-25 
PPU operation 6-3; 9-1 
remote assembly 5-3 
replication 4-61 
CODE micro 7-7 
CODE pseudo 

description 4-26 

effect on character data 2-14; 4-53 
example 4-27 
permissible anywhere 4-2 
Coding forma 2-3 
COL pseudo 

description 4-31 
octal listing 11-7 
Column one 2-1 
COM attribute 4-71 
Comma 

character string 2-14 
column one 2 -1 
continuatioii 2-1 
expression terminator 2-24 
local symbol separator 5-32 
name terminator 2-5 
parameter separator 5-8,13,16,25,28 
string terminator 2-14 
subfield delimiter 2-1 
COMMENT pseudo 
description 4-21 
example 4-14 
first statement group 4-2 
" omraents column control 4-31 
Conirnents field 2-2,3; 4-31 
Comments statement 2-2 

heading of definition 5-13 
micros not substituted 7-1 
not counted 4-63; 5-7,8 
permissible anywhere 4-2 
Comments, prefix table 4-21 
Compare character strings 4-73 
Compare expression values 4-67 
Compare/Move unit 8-51 
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COMPASS call statement 
description 10-2 
effect on LIST 4-77 
Compile file 10-4 

Comp and log difference instruction 8-31 
Comp and log sum instruction 8-31 
Complement instruction 8-30 
Compressed code 5-1 
CON pseudo 

description 4-58 
example 2-22; 4-59; 5-6, 23,27 
force upper 3-5 
Concatenation 2-4 
Concatenation mark 2-4 
example of use 5-19 
in definition 5-1 
Conditional assembly 4-63 
Conditional jump 

B register 8-26 
PPU 9-7 
X register 8-23 
Configuration 1-3 
Constant 

character 2-14 
description 2-10 
expression element 2-22,27 
field size 2-11 
generated by pseudo 4-58 
numeric 2-18 
read only 2-12 
Continuation, statement 2-2 
generation of lines 2-4; 7-1 
Control statements ' 

COMPASS 10-2 
job card 10-1 
SCOPE cards 10-1 
Core requirements 1-3; 10-2 
Counters, block control 3-4,11,13 
Counter control 
BSS 4-39 
forcing upper 3-5 
LOC 4-40 
ORG 4-35 
ORGC 4-35 
POS 4-42 
USE 4-32 
USELCM 4-34 


CPOP pseudo 6-8 
CPSYN pseudo 

description 6-11 
permissible anywhere 4-2 
CPU instructions 
block copy 8-14 
Boolean 8-28,29,30,31 
branching 8-23,26 
channel buffer 8-19,21 
channel status 8-22 
complement 8-30 
conditional 8-23,26 
direct LCM transfer 8-18 
divide 8-44 

double precision 8-38,41 

ECS 8-14 

error exit 8-12 

exchange exit 8-17 

exchange jump, 6000 8-16 

fixed point 8-38 

floatingpoint 8-38,39,40,41,44 

increment 8-46,48,49 

left shift 8-32,33 

logical 8-28,29,30,31 

long add 8-39 

mask 8-42 

multiply 8-40,41,42 

no operation 8-45 

normalize 8-34,35 

pack 8-37 

pass 8-45 

population 8-45 

program stop 8-11 

real-time clock 8-20 

return jump 8-13 

right shift 8-32,34 

set register 8-46,48,49 

set time 8-20 

shift 8-32, 33, 34 

single precision 8-37,39,40,41,44 
transmit 8-28 
unconditional jump 8-23 
unpack 8-36 

CPU program execution 1-3; 10-1 
CPU register designators 2-8; 8-8 
CRD instruction 9-17 
Created symbol 5-33, 11-9 
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CRM instruction 9-17 
Cross reference table 

(see symbolic reference i xble) 
CTEXT pseudo 4-84 
CU instruction 8-55 
CWD instruction 9-17 
CWM instruction 9-17 
CXi instruction 8-45 


D base 2-18; 4-23 
D code option 4-25 
D debug mode 10-3 
D definition flag 11-14 
D error 11-10 
D hardware feature code 4-8 
D list option 4-79 
Data generation 4-51 
Data item 

character format 2-14 
DATA pseudo 4-53 
general description 2-11 
LIT pseudo 4-55 
numeric format 2-18 
VFD pseudo 4-57 
Data notation 

character 2-14 
constant 2-11,14,18 
decimal 2-18 
element 2-11,24 
fixed point 2-18 ' 

floating point 2-18 
hexadecimal 2-23 
item 2-11,14,18 
literal 2-11,14,18 
numeric 2-18 
octal 2-18 
DATA psuedo 

description 4-52 

example 2-16,20,21; 4-27,33,37,52 
force upper 3-5 
Data transmission, PPU 9-3 
DATA micro 7-6 
Date of listing 11-1 
DCN instruction 9-22 
Debug mode 10-3 


Decimal exponent 2-19 
Decimal notation 2-18 
DECMIC pseudo 

description 7-4 
example 5-6; 7-4 
permissible anywhere 4-2 
uEF attribute 4-72 
E>efault symbols 
definition 2-7 
listing 11-9 
unqualified 4-27 
zero block 3-2 
Deferred symbols 

(see default symbols) 

I'^efinltion 

equt'/alenced macro 5-24 
aiacro 5-13,15,24 
micro 7-2 
opdef 5-13,27 
processing 5-13 
purging 6-9 
reference 5-18,25,30 
symbol 2-6; 4-42 
system 5-36 
Definition operation 

duplicated code 5-6 
equivalenced macro 5-13 
external text 5-2 
macro 5-13 
operation code 5-13 
processing 5-14 
recursion level 5-1 
remote text 5--3 
•Ximiter 

actual parameter 5-18,26 
data, item 2-14,18 
expression element 2-24 
field 2-1,2 

substitutable parameter 5-3,13,16 
term 2-24 

Descriptor, variable field 5-27; 6-7 
flestination field 2-28 
"'etailed listing 4-78; 11-1 
DF instruction 8-24 
Direct address 9-13 
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Directives, loader 4-23 
Directory, error 11-9 
DIS pseudo 

description 4-54 
example 4-54,55 
force upper 3-5 
Display code option 
character set A-1 
default mode 2-14 
option 4-26 

Divide instructions 8-44 
DM instruction 8-53 
Dollar sign 

local symbol separator 5-32 
parameter separator 5-8,13,16,25,28 
special element 2-6 
Double precision instructions 8-38,41 
DUP pseudo 

description 5-6 
example 5-10,11 
listing of count 11-7 
Duplicate symbol 
definition 2-6 
flag 11-14 
Duplication 
code 5-6 
echoed 5-7 
indefinite 5-7,9 
DXl instructions 
add 8-38 
multiply 8-41 


E code qptlon 4-26 
E entry point flag 11-14 
E error 11-10 
E list option 4-79 
E numeric data modifier 2-19 
ECHO pseudo 

description 5-7 
example 5-12 
ECS blocks 4-34 
Editing 2-4 

EE numeric data modifier 2-19 
EIM instruction 9-18 
EJECT pseudo 4-81 

permissible anywhere 4-2 


Eject suppression 10-4 
EJM instruction 9-17 
Element 

absolute 2-25 
data 2-10, 11 
expression 2-24,28 
external 2-27 
operator 2-24 
register 2-27 
relocatable 2-9,26 
special 2-9 
ELSE pseudo 

description 4-63 
example 5-5 

permissible anywhere 4-2 
END pseudo 

assembly of remote code 5-3 
binary generation 3-8 
description 4-5 

effect on blocks 3-1,8,11,15,16 
example 4-4,5,7,14,15,17,18,21,77 
external text use 5-3 
force upper 3-5 
illegal definitions 5-1 
permissible anywhere 4-2 
ENDD pseudo 

acting as nil 6-6 
description 5-10 
example 5-11 
permissible anywhere 4-2 
used with DUP 5-7 
used with ECHO 5-8 
ENDIF pseudo 

acting as nil 6-6 
description 4-63 
permissible anywhere 4-2 
ENDM pseudo 

acting as nil 6-6 
description 5-14 

example 4-29; 5-11,15,19,20,21,23,23,27, 
30,31,32,33,35,36 
permissible anywhere 4-2 
End-of-line mark 5-1 
ENDX pseudo 4-84 
Entry address 
absolute 4-4 
declaration 4-49 
multiple 3-15 
relocatable 4-5 
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ENTRY pseudo 

description 4-49 
example 4-5,49 
ENTRYC pseudo 4-49 
Entry point list 11-4 
Environment test 4-64 
EOM instruction 9-18 
EQ instruction 

description 8-26 
example 8-27 
force upper 3-5 
EQ IF operator 4-67 
IFC operator 4-73 
EQU pseudo 

description 4-43 

example 2-19,21; 4-21,29,41,43,62; 5 
listing 11-7 
Equal sign 

default symbol prefix 2-7 
instruction 4-43 
literals prefix 2-11,14,18 
local ssonbol separator 5-32 
parameter separator 5-8,13,16,25,28 
ERN instruction 9-12 
ERR pseudo 

description 4-75 
Error, assembly 
fatal 11-10 
informative 11~12 
programmer controller 4-75,7 6 
Error directory ' 

detailed description 11-9 
general description 4-78 
Error exit instruction 8-12 
Error flags 

conditionally set 4-75 
fatal 11-10 
informative 11-12 
unconditionally set 4-76 
where on listing 11-6 
ERRxx pseudo 4-76 
ES instruction 8-12 
ESN Instruction 9-23 
ETN instruction 9-12 
Evaluation of expression 2-27; 3-3 
Exchange exit instruction 8-17 
Exchange jump instruction 8-16 
Execution, CPU program 1-4 
EXN instruction 9-10 


Exponent 2-18 
Ejqpression 

absolute 2-25 
attribute 4-71 
comparison 4-67 
CON use 4-58 
description 2-24 
evaluation 2-24,28; 3-3 
examples 2-25,26,27 
external 2-27 
maximum size 2-28 
operators 2-24 
pass one value 2-28; 3-3 
pass two value 2-28; 3-3 
register 2-27; 8-2,10 
6 rules 2-24 

size 2-28 
types 2-25 

value 2-25,28; 3-3; 8-6 
VFD 4-57 
EXT attribute 4-71 
External BCD 

character set A-1 
cation 4-26 
External symbol 

declaration 4-50 
description 2-6 
External symbol list 11-5 
External text 

assembly 5-2 
file declaration 10-4 
listing 4-84 
EXT pseudo 

description 4-50 
illegal in absolute code 4- 


F conditional flag 11-14 
F error 11-11 
F FORTRAN mode 10-3 
F list option 4-79 
FAN instruction 9-22 
Fatal error flag 11-10 
Features of COMPASS 1-2 
Field 

comments 2-2; 4-31 
conventional 2-3 
delimiter 2-1,2 
destination 2-27; 4-57 


,9.10 


60360900C 


Index-7 


free 2-1 
location 2-1 
operation 2-1 
size 2-1 
subfield 2-2 
terminator 2-1 
variable 2-2 

File 

COMPILE 10-4 
INPUT 10-4 
LGO 10-3 
list output 10-4 
load and go 10-3 
OLDPC 10-5 
OPL 10-5 
OUTPUT 10-4 
source 10-4 

SYSTEXT 4-19; 10-3,5,6 
System text overlay 10-6 
Fill, blank 2-15 
Fill, zero 2-15 
FIM instruction 9-18 
First column 2-1 
First statement group 4-2 
Fixed point data notation 2-17 
Fixed point instructions 8-39,42 
FJM instruction 9-17 
Flag, error 

listing 11-6 
setting 4-75 
type 11-14,15 

Floating point data notation 2-17 
Floating point units 8-4,7 

add 8-37,38,39 ' 

divide 8-44 
multiply 8-40,41 
FNC instruction 9-22 
FOM instruction 9-18 
Forcing upper 3-4 
BSS 4-39 

CPU instructions 8-2 
LOC 4-40 

macro call 5-19,26 
opdef call 5-31 
ORG 4-35 
ORGC 4-35 
R= 4-59 
USE 4-32 
USELCM 4-34 
VFD 4-57 


Form, COMPASS coding 2-3 
Format 

control statement 10-1 
CPU instruction 8-1 
line 2-1 
listing 11-1 
PPU instruction 9-1 
FORTRAN 2-6; 4-4; 10-3 
Full list 10-3 
Functional units 8-4,7 
Functions, PPU 
arithmetic 9-4 
data transmission 9-3 
logical 9-4 
replace 9-5 
FXi instruction 
add 8-37 
divide 8-44 
multiply 8-40 


G assembly mode 10-3 
G list option 4-79 
GE instinictions 8-26 
GE IF operator 4-67 
IFC operator 4-73 
Generated code listing 4-79 
Generation, data 4-51 
Get text mode 10-3 
GT instruction 8-27 
GT IF operator 4-67 
IFC operator 4-79 
Guaranteed zero 2-15; 4-54 


Hardware configuration 1-3 
Hardware feature dependency 4-8 
Heading 

listing 4-78; 11-1 
macro 5-13 
cpdef 5-13 
HERE pseudo 

description 5-4 
permissible anywhere 4-2 
Hexadecimal data 2-23 

I code option 4-22 
I hardware feature code 4-8 
I input mode 10-4 
I NOLABEL option 4-22 
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lAM mstruction 9-21 
IAN instruction 9-20 
IBj instruction 8-22 
ID instruction 8-24 
IDENT pseudo 

binary generation 3-8,10 
blank variable field 3-16; 4-12 
description 4-2,11 
example 4-4,7,14,15,17,18,21,50 
force upper 3-5 
overlay generation 3-8,10 
program identification 4-2 
IF pseudo 4-70 
IF skipped lines listed 4-79 
IFCP pseudos 4-64 
IFC pseudo 

description 4-73 
example 5-5,11 
permissible anywhere 4-2 
IFop pseudo 4-67 
IFPP pseudo 4-64 
IFtype pseudo 4-64 
IJM instruction 9-17 
IM instruction 8-51 
Increment unit 8-4,7,46,48,49 
Indexed address, PPU 9-15 
Index register 8-8 
Indirect address, PPU 9-14 
Input, assembler 10-2,24 
Instructions 

coding of 2-1 
CMU 8-51 
CPU 8-1 

mnemonically identified 6-3 
nil 6-7 

no-operation 8-45; 9-9 
PPU 9-1 
pseudo 4-1 
redefinition 5-16,25 
synonymous 6-5,11 
syntactically identified 6-8 
Integer add 8-39 
Integer subtract 8-39 
Integer multiply 8-42 
Integer value 2-17 


Internal BCD 

character set D-1 
option 4-26 

Invented symbol 5-33; 11-9 
IR instruction 8-24 
IRM instruction 9-18 
IRP pseudo 

acting as nil 6-7 
description 5-34 
example 5-35,36 
permissible anywhere 4-2 
DCi instructions 8-39,42 


J cation 4-9,11; 9-5 
JDATE micro 7-6 
Job statement 10-1 
Job priority 10-1 
JP instruction 

description 8-23 
force upper 3-5 


L control statement option 
description 10-4 
related to LIST 4-78 
L error 11-10 
L hardware feature code 4-8 
L list option 4-79 
L location flag 4-40,11-14 
Labeled common 
description 3-3 
establishment 4-32,34 
LCC pseudo 

description 4-23 
illegal if absolute 4-6,9,11 
LCM attribute 4-71 
LCM blocks 3-3; 4-34 
LCM transfer instructions 8-14.1, 18 
LCN instruction 

data transmission 9-3 
description 9-8 
LDC instruction 

data transmission 9-3 
description 9-9 
example 2-22 
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LDD instruction 

data transmission 9-3 
description 9-13 
LDI instruction 

data transmission 9-3 
description 9-14 
LDM instruction 

data transmission 9-3 
description 9-15 
example 5-21 
LDN instruction 

data transmission 9-3 
description 9-8 
example 5-12; 9-8 
Left shift instruction 8-32, 33 
LE IF operator 4-67 
IFC operator 4-73 
LE instruction 8-26 
Library maintenance programs 2-1 
LGO control statement 10-4 
Linkage symbols 2-7; 4-48 
Listable output 

assembled code 11-6 
assembler statistics 11-9 
binary control cards 11-1 
block usage 11-3 
control statement control 10-4 
default symbols 11-9 
entry point symbols 11-4 
error directory 11-9 
error flags 11-10,11 
external symbols '11-5 
header information 11-1 
literals 11-8 
source statements 11-6 
statistics 11-9 
subtitles 11-1 

symbolic reference table 11-13 
titles 11-1 

user control 4-77; 10-3,4 
List, full 10-3 
Listing control 

control card 10-3,4 
pseudo 4-77 


List, parameter 
ECHO 5-8 

equivalenced macro 5-25 
macro 5-18 
LIST pseudo 

description 4-77 
example 4-14; 5-6,12 
permissible anywhere 4-2 
List, short 10-4 
Literals 

absolute program 3-10 
description of block 3-1,2 
IDENT 3-11,17 
listing 11-8 
location 1-3; 3-1,2 
notation 2-11 
PPU overlay 3-13 
protection 4-33 
SEGMENT overlay 3-13 
SEG partial binary 3-15 
symbol (default) 2-7 
LIT pseudo 

description 4-55 

example 2-12,17,21; 4-15,56; 5-6 
listing 11-7,8 
LJM instruction 

description 9-6 
example 5-21 
LMC instruction 
description 9-9 
logical function 9-5 
LMD instruction 

description 9-13 
logical function 9-5 
LMI instruction 

description 9-14 
logical function 9-5 
LMM instiaiction 

description 9-15 
logical function 9-5 
LMN instruction 
description 9-8 
logical function 9-5 
LO control statement option 10-4 
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Load address 4-3 
Load-and-go file 1-3; 10-3 
Loader control card 4-23 
LOC attribute 4-71 
Local blocks 3-2 

absolute program 3-7 
description 3-2 
establishment 4-32,34 
relocatable program 3-5 
LOCAL statement 
description 5-32 
example 5-33 
heading 5-13 
Local symbol 

CPU instruction 8-5 
macro body 5-13 
subprogram 3-1; 4-27 
Location counter 
BSS 4-39 
control 4-40 
description 3-5 
forced upper 3-5 
ORG 4-35 
ORGC 4-35 

special element 2-9; 3-5 
USE 4-32 
USELCM 4-34 
Location field 

listing 11-6 \ 

statement 2-1 
LO control card option 
description 10-4 
related to LIST 4-77 
LOC pseudo 

description 4-40 
example 4-41,59 
location counter changed 3-5 
Logical difference instruction 8-29 
Logical functions, PPU 9-4 
Logical minus 2-24 
Logical product instruction 8-28 
Logical prod and comp Instruc 8-30 
Logical shift instruction 8-32,33 
Logical sum instruction 8-29 


Long add unit 

description 8-4,7 
instructions 8-39 
LPC instruction 

description 9-9 
logical function 9-5 
LPN instruction 
description 9-8 
logical function 9-5 
LT IF operator 4-67 
IFC operator 4-71 
LT instruction 8-27 
LXi instruction 8-32,33 
example 2-20 


M base option 4-24 
M list cation 4-79 
Machine test 4-64 
MACHINE pseudo 4-7 
Macro 

body 5-13 
call 5-18,25 
equivalenced 5-24 
definition 5-13 
header 5-14 
list control 4-79 
name 2-2; 5-15,18,25; 6-1 
permissible anywhere 4-2 
processing 5-1,14 
system defined 4-80; 5-36 
terminator 5-14 
MACROE pseudo 

description 5-24 
example 5-27 
IRP related 5-35 
operation code table entry 6-1 
permissible anywhere 4-2 
MACRO pseudo 

description 5-15 

example 4-29,74; 5-5,19,20,21,22,33,35,36 
IRP related 5-35 
operation code table entry 6-1 
permissible anywhere 4-2 
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MAN instruction 9-10 
Mask instruction 8-4 
Mass storage, system 1-3 
Master list control 4-77 
MAX pseudo 

description 4-45 
listing 11-7 
MD instruction 8-52 
MI instruction 8-24,26 
MIC attribute 4-72 
MICCNT pseudo 

description 4-47 
example 4-47 
listing 11-7 

permissible anywhere 4-2 
MICRO 

decimal 7-4 

definition 4-23, 25,27; 7-2 
editing 2-4 
mark 2-4; 5-1 
octal 7-4 
reference 7-1 
size 4-47; 7-2 
system defined 4-19; 7-2,5 
test for 4-72 
MICRO pseudo 

description 7-2 
example 4-47; 5-11; 7-2,3 
permissible anywhere 4-2 
MI instructions 8-24,26 
MIN pseudo 

description 4-46 
listing 11-7 ' 

Minus as local symbol separator 5-32 

Minus as parameter separator 5-8,13,16,25,28 
Minus on listing 11-7 
Minus operator 2-24,25; 8-5 
Minus sign in location field 

CPU instruction 3-4, 5; 4-57 
PPU instruction 3-5; 4-57 
VFD instruction 4-57 
MJ instruction 8-17 
force upper 3-5 
MJN instruction 
description 9-6 
effect of J 4-9,11 


ML control statement option 10-4 
Mnemonic operation code 

legal operation field entry 2-1 
OPDEF defined 5-27 
search for 6-1 

Modifiers, numeric data 2-19 
MODIFY common decks 5-2 
MODLEVEL micro 7-7 
Multiple entry point table 
suppression 4-22 
used for overlays 3-15 
MXi instruction 

description 8-43 
example 2-20; 8-43 
MXN instruction 

description 9-10 

N eject mode 10-4 
N error 11-11 
N list option 4-80 
Name 

block 4-32, 34 
different types 2-5 
duplicate code 5-7,8 
general description 2-5 
IF sequence 4-63 
macro 5-16 

micro 4-23,25,27; 7-2,4,5 
mnemonic operation 6-1 
overlay 4-12,16 
parameter 5-8 
remote code 5-3 
NE instruction 8-26 
NE IF operator 4-67 
IFC operator 4-73 
Nesting, level of 1-3 
NG instruction 8-24,26 
NIL pseudo 6-6 

permissible anywhere 4-2 
NIM instruction 9-18 
NJN instruction 

description 9-6 
effect of J 4-9,11 
NO eject option 10-3 
NO instruction 8-45 
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NOLABEL pseudo 
description 4-22 
permissible anywhere 4- 2 
NOM instruction 9-18 
NOREF pseudo 4-83 

permissible anywhere 4-2 
Normalize instmiction 8-34.1,35 
Normalize unit 

description 8-7 
instructions 8-34.1,35 
Not equal sign 

parameter separator 5-8,13 
special character 2-4 
Numeric data 2-18 
NXi Instruction 8-35 
NZ instruction 8-24,26 


O base 2-18; 4-24 
O error 11-10 
O mode 10-5 
OAM instruction 9-21 
OAN instruction 9-20 
OBj instruction 8-22 
Octal listing 11-6 
Octal notation 2-18 
OCTMIC pseudo 7-4 

permissible anywhere 4-2 
OLD PL file 10-3 , 

Opdef 

body 5-13 
call 5-30 
definition 5-13 
heading 5-14 
list control 4-79,80 
processing 5-14 
system defined 4-19,36 
OPDEF pseudo 

description 5-27 
example 5-29,30,31,32 
operation code table entry 6-1 
permissible anywhere 4-2 
Operand register 8-8 
Operation code table 6-1 


Operation code value 
CPU 6-9; 8-1 
PPU 6-4; 9-1 
Operation, definition 
compressed 5-1 
duplicated text 5-6 
external text 5-2 
general description 5-1 
macro definition 5-13 
opdef definition 5-13 
remote text 5-3 
system 5-36 
Operation field 
blank 4-51 
description 2-1 
search 6-1 
Operator 

element 2-22 
mnemonic 5-27; 6-3 
register 2-23; 5-28; 6-8 
term 2-24 

Operator with constant 2-14,18 
OPL file 5-2; 10-3 
OPSYN pseudo 

description 6-5 
permissible anywhere 4-2 
ORG pseudo 

description 4-35 
determine blocks 3-1 
establish absolute blocks 3-2; 4-35 
example 4-4,7,14,15,17,37,41,50 
location counter changed 4-35 
origin counter changed 3-3; 4-35 
ORGC pseudo 4-35 
Origin 

multiply entry point 4-3 
overlay 4-12,16 
program 4-3 
Origin counter 
BSS 4-39 

control 3-3; 4-35,39 
description 3-4 
final value, absolute 3-S 
final value, relocatable 3-6 
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forced upper 3-4,5 
maximum value 3-8 
ORG 4-35 
ORGC 4-35 

special element 2-9; 3-3 
USE 4-32 

OR instruction 8-24 
ORM instruction 9-18 
Overflow error 2-19 
Overlay 

absolute 3-8 
entry point 4-12,16 
general description 3-10 
level numbers 3-19; 4-4,12,16 
multiple entry point 3-15 
name 4-12,16 
origin 4-12,16 
PPU 3-10 

primary 3-10; 4-12,16 
secondary 3-10; 4-12,16 


P error 11-11 

P numeric data modifier 2-19 

P pagination mode 10-5 

Pack instruction 8-37 

Padding of CPU word 3-5; 4-57; 8-2 

Page heading 11-1 

Page number 11-1 

Pagination control 10-4 

Parameter 

actual 5-7,18,26 
embedded 5-18,26 
formal 5-8,13 
indefinitely repeated 5-35 
iterative 5-18,26,35 
substitutable 5-8,13,16, 25, 28, 35 
Parameter mark 5-9,13 
Parameter, null 5-9,18,26 
Parameter separator 
actual 5-18,26 
formal 5-8,13,16 
Parcel 8-1 
Parentheses 

local symbol separator 5-32 
nested 5-9 

parameter separator 5-8,13,16, 25, 28 


Partial binary 

ID ENT type 3-16 
SEG type 3-15 
Pass instruction 
CPU 8-45 
PPU 9-9 
Pass one 

expression evaluation 2-25,28; 3-4 
general description 1-3 
maximum test 4-45 
minimum test 4-46 
symbol definition 2-6 
Pass two 

expression evaluation 2-25,28; 3-4; 8-2 
general description 1-3 
symbol definition 2-6 
value for MAX 4-45 
value for MIN 4-46 
PC control statement option 10-5 
PCOMMENT micro 7-8 
PERIPH pseudo 

description 4-10 
effect on branch instructions 9-5 
example 4-53; 6-5 
first statement group 4-2 
PJN instruction 

description 9-6 
effect of J 4-9,11 
PL instruction 8-24,26 
Plus in location field 

CPU instruction 3-4 
PPU instruction 3-5 
VFD instruction 4-57 

Plus as parameter separator 5-8,13,16,25,28 

Plus as local name separator 5-32 

Plus on listing 11-7 

Plus operator 2-24,25; 8-5 

Point 

binary 2-18,19 
decimal 2-18,19 
octal 2-18,19 

parameter separator 5-8,13,16, 25, 28 
register designator 2-8 
Population unit 8-45 
Position counter 

control 4-42,57 
description 3-4 
special element 2-9; 3-4 
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POS poeudo 4-42 
Post radix 2-18 
PPOP pseudo 

description 6-3 
example 5-12; 6-5 
permissible anywhere 4-2 
PPU instructions 9-1 
A-register I/O 9-20 
block I/O 9-20 
branch I/O 9-17,18 
branch 9-5 

central read/write 9-16 
channel function 9-22 
constant mode 9-9 
designators 9-3 
direct address 9-13 
error stop 9-23 
exchange jump 9-10 
format 9-1 
functions 9-3 

indexed direct address 9-15 
indirect address 9-14 
jump 9-7 
no address 9-8 
no operation 9-9 
output record flag 9-22 
shift 9-7 
PPU pseudo 

description 4-9 
effect on branch 9-5 
example 4-10,55 
first statement group 4-2 
Prefix table 

comments 4-21 
generation 3-8 
suppression 4-22 
Preradix 2-18 
Program, absolute 3-7; 4-6 
Program execution 10-5 
Program identification 4-3 
Program origin 4-3 
Program, relocatable 3-5 
Program stop instruction 8-11 
Program structure 3-1 


Pseudo instructions 

binary control 4-6 
block counter control 4-32 
conditional assembly 4-63 
data generation 4-51 
definition operation 5-1 
error control 4-75 
first statement group 4-2 
introduction 4-1 
listing control 4-77 
micro 7-1 
mode control 4-23 

operation code table management 6-1 
operation field entry 2-2 
permissible anywhere 4-2 
required 4-2 

subprogram identification 4-2 
subprogram linkage 4-48 
symbol definition 4-42 
tyi)es 4-1 
PS instruction 

description 8-11 
force upper 3-5 
PSN instruction 9-9 
PURGDEF pseudo 
description 6-11 
permissible anywhere 4-2 
PURGMAC pseudo 
description 6-7 
example 6-6 

permissible anywhere 4-2 
Push down stack 1-3 
PXi instruction 8-37 


Q to represent expression 5-27; 6-8 
Qualifier, symbol 4-28 

used for definition operations 5-2 
QUAL micro 7-7 
QUAL pseudo 

description 4-27 
example 4-14,29; 5-22 
permissible anywhere 4-2 
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Rerror ll-io 
R hardware feature code 4-8 
R list option 4-80 
R= pseudo 

description 4-59 
example 4-60; 5-21 
illegal in PPU program 4-9,11 
RAD instruction 

description 9-13 
replace function 9-5 
Radix 2-18,19 
RAI instruction 

description 9-14 
replace function 9-5 
ram instruction 

description 9-15 
replace function 9-5 
Real-time clock set instruction 8-20 
Record name, external text 5-3 
Recursion level 1 - 4 ; 5-1 
Recursion stack 1 - 4 ; 5 -i 
Reference 
external 
macro 5-18 
macroe 5-25 
nested 5-1 
opdef 5-30 

Reference table, symbolic II -13 
Registers, CPU 2-8; 8-8 
Register designators 
CPOP 6-8 
description 2 - 8 ; 8-8 
not symbols 2-6 
OPDEF 5-27 
OPSYN 6-11 
PURGDEF 6-11 
RE instruction 

description 8-14 
force upper 3-4 
REL attribute 4-71 
Relocatable program structure 3-5 
Relocatable test 4-71 
Remote assembly 5-3 
Repeat count 
DUP 5-7 
replication 4-61 


REP pseudo 4-61 
REPC pseudo 4-61 
RE PI pseudo 

example 4-62 
description 4-61 
illegal if absolute 4-6,9,11 
RE PL table 

result of BSSZ 4-52 
result of REP, REPC, or RE PI 4-61 
written by SEGMENT 4-16 
Replace functions, PPU 9-5 
Replication of code 4-61 
Return jump, CPU 8-13 
RFN instruction 9-22 
RI instruction 8-20 
Right shift 8-32,34 
RJ instruction 

description 8-13 
example 4-33; 5-21; 8-13 
force upper 3-5 
RJM instruction 9-6 
RL instruction 8-15 
RMT pseudo 

description 5-3 
example 5-5,6 
permissible anywhere 4-2 
RO Instruction 8-21 
Round and normalize instruction 8-35 
RPN instruction 9-11 
RXi instructions 
add 8-39 
divide 8-44 
multiply 8-41 
RXj instruction 8-18 

S list option 4-80 
S numeric data modifier 2-18 
S storage flag 11 -14 
S system text mode 10-5 
SAi instructions 

description 8-46 

example 2-16,17,20; 4-33,39; 5-22,35- 
SBD instruction 

arithmetic function 9-4 
description 9-13 


1-47 
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SBI instruction 

arithmetic function 9-4 
description 9-14 
SBi instructions 

description 8-48 
example 2-11,15; 4-52; 8-49 
SBM instruction 

arithmetic function 9-4 
description 9-15 
SBN instruction 

arithmetic function 9-4 
description 9-8 
Scale, binary 2-19 
SCM blank common 3-3 
SCM labeled common 3-2 
SCN instruction 

description 9-8 
logical function 9-5 
SEG pseudo 

binary generation 3-15 
description 4-17 
example 4-18 
force upper 3-5 
illegal in PPU program 4-9,11 
SEGMENT pseudo 

binary generation 3-7 
description 4-16 
example 4-17 
force upper 3-5 
illegal in PPU program 4-9,11 
overlay structure 3-13 
Semicolon in definition 5-9,13 
SEQUENCE micro 7-7 
Sequencing 

listing 11-7 
statement 2-1 
SET attribute 4-71 
Set instructions 8-46,48,49 
SET pseudo 

description 4-44 
example 2-9,22; 5-11,22 
listing 11-7 

Shift 

description of unit 8-4,7 
CPU instructions 8-32,33,34,35,36,37,43 
PPU instructions 9-7 
SHN instruction 9-7 


Short jump limit 4-9,11 
Short list 10-4 
Single precision instructions 
add rounded 8-39 
add unrounded 8-37 
divide rounded 8-44 
divide unrounded 8-44 
multiply rounded 8-41 
multiply unrounded 8-40 
SKIP pseudo 

description 4-75 
permissible anywhere 4-2 
Slant bar 

local symbol separator 5-32 
operator 2-23,24; 8-5 
parameter separator 5-8,13,16,25,28 
SOD instruction 

description 9-13 
replace function 9-5 
SOI instruction 

description 9-14 
replace function 9-5 
SOM instruction 

description 9-15 
replace function 9-5 
Space, embedded (see blank) 

SPACE pseudo 

description 4-81 
permissible anywhere 4-2 
%)ecial elements 

FORTRAN call 2-9 
general description 2-9 
in variable field 2-2 
location counter 3-5 
origin counter 3-3 
position counter 3-5 
SST attribute 4-72 
SST pseudo 4-48 
example 4-14 
permissible anywhere 4-2 
Stack, recursion 1-4; 5-1 
Statement 

coding conventions 2-3 
comments 2-2 
compressed 5-1 
continuation 2-2 
external source 5-2 
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first column 2-1 
first group 4-1 
format 2-1 
listing 11-5 

number assembled 11-9 
size 2-1 

source of 5-1; 10-3 
Statistics, assembler 11-9 
STD instruction 

data transmission function 9-3 
description 9-13 
STEXT pseudo 

description 4-19 
example 4-21 
first statement group 4-2 
STI instruction 

data transmission function 9-3 
description 9-14 
STM instruction 

data transmission function 9-3 
description 9-15 
STOPDUP pseudo 
description 5-9 
example 5-11 

Storage reservation 4-39,51 
String, character 

comparison 4-73 
data generation 4-53 
delimited 2-10,15 
empty 2-15 
micro 2-4 
notation 2-14 
Subprogram length 3-6 
Substitution, micro 7-1 
Subsubtitle 

CTEXT 4-84 
EJECT 4-81 
listing of 11-1 
QUAL 4-27 
SPACE 4-81 
TITLE 4-82 
TTL 4-83 
Subtitle 

CTEXT 4-84 
listing of 11-1 
TITLE 4-82 


SXi instruction 

description 8-49 
example 2-16,20; 5-21,35; 8-50 
l^mbol 

attribute 2-6; 4-42,71 
created 5-33 
default 2-7 
definition 2-6; 4-42 
duplicate 2-6 
entry point 2-6 
external 2-7 
invented 5-33;11-9 
literals 2-7 
local to macro 5-13,33 
local to QUAL 3-1 
location field 2-6 
lost 11-9,13 
number defined 11-9 
number referenced 11-9 
previously defined 2-8 
qualified 2-8; 4-27 
redefinition 4-44 
system-defined 2-7; 4-48 
undefined 2-8 
value 2-6; 4-42 
Symbol qualifier listed 11-1 
Symbol table 

clearing 3-10,12 
system text 4-19 
Slymbolic reference table 
address reference 4-85 
detailed description 11-13 
general description 4-78 
generation 1-3 

list control 4-78, 83, 85; 10-3,4 
omit symbol 4-83 
l^nonymous operation 
CPU 6-11 
mnemonic 6-5 
PPU 6-5 
syntactic 6-8 

Syntax definition 5-27; 6-8,11 
Syntax search 6-1 
System text 4-19 
SYSTEXT option 10-4 

related to G mode 10-3 
related to STEXT 4-19 
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T list option 4-80 
Table 

operation code 6-1 
symbolic reference 11-13 
USE 4-32 

TBj instruction 8-29 
Term 2-24 
Term operator 2-23 
Terminator, macro 5-13 
Test symbol attribute 4-71 
Time limit 10-2 
TIME micro 7-5 
Time of assembly 11-1 
Title 

ES 8-12 
IDENT 4-4 
listing of 11-1 
PS 8-11 
TITLE 4-82 
TITLE pseudo 4-82 

permissible anywhere 4-2 
Transfer symbol 4-5 
Transmit instruction 8-28 
Truncation, character data 2-13 
expression value 2-27 
TTL pseudo 4-83 

permissible anywhere 4-2 


U error 11-11 
UJN instruction 

effect of J 4-9,11 
description 9-6 
Unconditional jump 
CPU 8-23 
PPU 9-6 

Underflow error 2-19 
Unpack instruction 8-36 
USE pseudo 

change blocks 3-1; 4-32 
description 4-32 

establish common blocks 3-3,4; 4-32 
establish local blocks 3-2; 4-32 
example 4-18,29,31,33,35,37,39 


USE table 

entry 4-32,33,35 
reinitialization 3-10,12; 4-12 
USELCM pseudo 

description 4-34 
establish common blocks 3-3 
example 4-34 

illegal in PPU program 4-9,11 
UXi Instruction 8-36 


V error 11-11 
Value, numeric 2-17 
Variable field 2-2 
Variable field definition 4-57 
VFD pseudo 

description 4-57 

example 2-16; 4-25,26,33,58; 5-22 


WE instruction 

description 8-14 
force upper 3-5 
WL instruction 8-15 
WXj Instruction 8-18 


X external flag 4-50; 11-7 
X external text mode 10-5 
X file option 

description 10-5 
XTEXT default 5-3 
X hardware feature code 4-8 
X list option 4-80 
X register 

conditional instructions 8-24 
description 8-4 
designator 2-8 
setting 8-49 
XJ instruction 

description 8-16 
force upper 3-5 
XREF pseudo 

description 4-85 
permissible an 5 fwhere 4-2 
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XTEXT pseudo 5-1 

related to CTEXT/ENDX 4-84 
XTEXT source 10-5 


Zero block 

absolute program 3-2 
description 3-2 
relocatable program 3-6 
Zeroed words 4-51 
Zero fill 2-15; 4-57 
Zero guaranteed 
data Item 2-15 
DIS item 4-54 
ZJN Instruction 
description 9-6 
effect of J 4-9,11 
ZR instruction 

description 8-24,26 
force upper 3-5 
ZXi instruction 8-35 
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Seetton 




Seotlon 

Name 

Phteernem 

Usage 

Nmnber 

Name- 

Plaoenseat 

Usage 

Ntmdwr 

ABS 

first group 

CPA 

4.3.1 

MACRCffi 

anywhere 

CP.PP 

5.4.4 

BASE 

agywfaere 

CP.PP 

4.4.1 

MAX 

normal 

CP.PP 

4.6.3 

BSS 

normal 

CP,PP 

4.5.4 

MICCNT 

aosnvtere 

CP.PP 

4,6.5 

BSSZ 

nomal 

CP.PP 

4.8.1 

MICRO 

aiqwliere 

CP.PP 

7.2.1 

m=i 

anywhere 

CP 

4.4.5 

MIN 

normal 

CP.PP 

4.6.4 

B7=l 

amnshere 

CP 

4.4.5 

NIL 

anywhere ’ 

CP.PP 

6.1.3 

CHAR 

anywhere 

CP.PP 

4.4.2 

NOLABEL 

anywhere 

CP.PP 

4. 3. le 

CODE 

anywhere 

CP.PP 

4.4.S 

NOREF 

anywhere 

CP.PP 

4.11.6 

COL 

nm?mal 

CP.PP 

4.4.6 

OCTMIC 

anywhere 

CP.PP 

7.2.3 

COMMENT 

anywhere 

CP.PP 

4,3.9 

OPDEF 

anywhere 

CP 

S.4.6 

CON 

normal 

CP.PP 

4.8.6 

OPSYN 

anywhere 

CP.PP 

8.1.2 

CPOP 

anywhere 

CP 

8.2.1 

ORG 

normal 

CP.PP 

4.5.3 

CPSYN 

anywhere 

CP 

6.2.2 

OROC 

normal 

CP.PP 

4.5.3 

CTEXT 

normal 

CP 

4.11.7 

PERIPH 

first groiq> 

PP 

4.3.4 

DATA 

normal 

CP.PP 

4.8.2 

P06 

normal 

CP.PP 

4.5.6 

DECMIC 

anywhere 

CP.PP 

7.2.2 

PPOP 

anyediere 

PP 

6.1.2 

DIS 

normal 

CP.PP 

4. 8.3 

PPU 

first group 

PP 

4. 3.3 

DUP 

nmrmat 

CP.PP 

6.3.1 

PUBG0EF 

anytttere 

CP 

6.2.3 

ECHO 

normal 

CP.PP 

5.3.2 

PUBQMAC 

anyadtere 

PP 

6.1.4 

EJECT 

anywhere 

CP.PP 

4.11.2 

QUAL 

anywhere 

CP.PP 

4.4.3 

ELSE'^ 

anywhere 

CP.PP 

4. 9.2 

REP 

nomaal 

CPR 

4.8.8 

END^ 

required lent 

CP.PP 

4.2.2 

RE PC 

normal 

CPR 

4. 8.8 

ENDD 

anywhere 

CP.PP 

5.3.4 

REPI 

normal 

CPR 

4.8.8 

ENDIF* 

ai^where 

CP.PP 

4.9.1 

RMT 

anywhere 

CP.PP 

5.2.1 

ENDM 

anywhere 

CP.PP 

5.4.1 

Rf= 

normal 

CP 

4.8.7 

ENDX 

normal 

CP.PP 

4.11.7 

SEG 

normal 

CPA.PP 

4. 3.7 

ENTRY 

normal 

CP.PP 

4.7.1 

SEGMENT 

normal 

CPA.PP 

4.3.6 

ENTKYC 

normal 

CP.PP 

4.7.1 

SET 

normal 

CP.PP 

4.6.2 

EQU 

normal 

CP.PP 

4.6.1 

SKIP 

anywhere 

CP.PP 

4.9.7 

ERR 

normal 

CP.PP 

4.10.1 

SPACE 

anywhere 

CP.PP 

4.11.3 

ElffiMI 

normal 

CP.PP 

4.10.2 

SST 

anywhere 

CP.PP 

4. 6.6 

ERBNG 

normal 

CP.PP 

4,10.2 

STEXT 

first group 

CP.PP 

4.3.8 

ERRNZ 

normti 

CP.PP 

4.10. 2 

STOPDUP 

normal 

CP.PP 

5.3.3 

erhpl 

normal 

CP.PP 

4.10.2 

TITLE 

anywhere 

CP.PP 

4.11.4 

ERRZR 

normal 

CP.PP 

4.10.2 

TTL 

anywhere 

CP.PP 

4.11.5 

EXT 

normal 

CP.PP 

4.7.2 

USE 

normal 

CP.PP 

4. 5.1 

HERE 

anywhere 

CP.PP 

5.2.2 

USELCM 

normal 

CP 

4. 5.2 

IDENT 

required first 

CP.PP 

4.2.1 and 

VFD 

normal 

CP.PP 

4. 8.5 




4.3.5 

XREF 

anywhere 

CP.PP 

4.11.8 

IF 

normal 

CP.PP 

4.9.5 

XTEXT 

normal 

CP.PP 

5.1 

IFC 

anywhere 

CP.PP 

4.9.6 

(blank) 

normal 

CP.PP 

4.8.1 

IFCP 

normal 

CP. PP 

4.9.3 

* 

normal 

CP.PP 

4.6.1 

IFCP6 

normal 

CP.PP 

4. 9.3 





IFCP7 

normal 

CP.PP 

4.9.3 





IFGE 

normal 

CP.PP 

4.9.4 





IFGT 

normal 

CP.PP 

4.9.4 





IFLE 

normid 

CP.PP 

4.9.4 





IFLT 

normal 

CP.PP 

4.9.4 

Legend 




IFMI 

normal 

CP.PP 

4. 9.7 





IFNE 

normal 

CP.PP 

4. 9.4 

CP 

Absolute or reldcatable CPU program 

IFPL 

normal 

CP.PP 

4. 9.7 

CPA 

Absolute CPU program 


IFPP 

normal 

CP.PP 

4. 9.3 

CPR 

Relocatable CPU program 


IFPP6 

normal 

CP.PP 

4. 9.3 

PP 

Absolute PPU program 


IFPP7 

normal 

CP.PP 

4.9.3 





IFEQ 

normal 

CP.PP 

4.9.4 





IRP 

anywhere 

CP.PP 

5.4.9 





LCC 

normal 

CPR 

4.3.11 





LIST 

anywhere 

CP.PP 

4.11.1 





LIT 

normal 

CP.PP 

4.8.4 





LOG 

normal 

CP.PP 

4.5.5 





LOCAL 

macro or opdef 

CP.PP 

5.4.8 





MACHINE 

first group 

CP.PP 

4.3.2 





MACHO 

! 

aiQwhere 

CP.PP 

5.4.2 





I 

1 

i 

j 

' ^ Looked for during IF skipping. 








